目次

AKRESULT __cdecl AK::SoundEngine::PrepareEvent ( PreparationType  in_PreparationType,
const char **  in_ppszString,
AkUInt32  in_uNumEvent,
AkBankCallbackFunc  in_pfnBankCallback,
void *  in_pCookie  
)

Prepare or un-prepare an event asynchronously. The events are identified by string (refer to 概説 for a discussion on using strings and IDs). The event definitions must already exist in the sound engine by having explicitly loaded the bank(s) that contain them (with LoadBank()). A request is posted to the Bank Manager consumer thread. It will resolve all dependencies needed to successfully post the events specified, and load the required banks, if applicable. The function returns immediately. Use a callback to be notified when the request has finished being processed.

戻り値:
AK_Success if scheduling is was successful, AK_Fail otherwise.
意見:
Whenever at least one event fails to be resolved, the actions performed for all other events are cancelled.
参照:
引数:
in_PreparationType  Preparation type ( Preparation_Load or Preparation_Unload )
in_ppszString  Array of event names
in_uNumEvent  Number of events in the array
in_pfnBankCallback  Callback function
in_pCookie  Callback cookie (reserved to user, passed to the callback function)