Version

menu_open
Wwise SDK 2023.1.3

◆ PostMIDIOnEvent()

AKSOUNDENGINE_API AkPlayingID AK::SoundEngine::PostMIDIOnEvent ( AkUniqueID  in_eventID,
AkGameObjectID  in_gameObjectID,
AkMIDIPost in_pPosts,
AkUInt16  in_uNumPosts,
bool  in_bAbsoluteOffsets = false,
AkUInt32  in_uFlags = 0,
AkCallbackFunc  in_pfnCallback = NULL,
void *  in_pCookie = NULL,
AkPlayingID  in_playingID = AK_INVALID_PLAYING_ID 
)

Executes a number of MIDI Events on all nodes that are referenced in the specified Event in an Action of type Play. The time at which a MIDI Event is posted is determined by in_bAbsoluteOffsets. If false, each MIDI event will be posted in AkMIDIPost::uOffset samples from the start of the current frame. If true, each MIDI event will be posted at the absolute time AkMIDIPost::uOffset samples. To obtain the current absolute time, see AK::SoundEngine::GetSampleTick. The duration of a sample can be determined from the sound engine's audio settings, via a call to AK::SoundEngine::GetAudioSettings. If a playing ID is specified then that playing ID must be active. Otherwise a new playing ID will be assigned.

Returns
The playing ID of the event launched, or AK_INVALID_PLAYING_ID if posting the event failed and an error will be displayed in the debug console and the Wwise Profiler.
See also
Parameters
in_eventIDUnique ID of the Event
in_gameObjectIDAssociated game object ID
in_pPostsMIDI Events to post
in_uNumPostsNumber of MIDI Events to post
in_bAbsoluteOffsetsSet to true when AkMIDIPost::uOffset are absolute, false when relative to current frame
in_uFlagsBitmask: see AkCallbackType
in_pfnCallbackCallback function
in_pCookieCallback cookie that will be sent to the callback function along with additional information
in_playingIDTarget playing ID

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise