Version

menu_open
typedef void( * AkBankCallbackFunc)(AkUInt32 in_bankID, const void *in_pInMemoryBankPtr, AKRESULT in_eLoadResult, AkMemPoolId in_memPoolId, void *in_pCookie)

Callback prototype used with asynchronous bank load/unload requests. This function is called when the bank request has been processed and indicates if it was successfully executed or if an error occurred.

Parameters:
in_bankID  Identifier of the bank that was explicitly loaded/unloaded. In the case of PrepareEvent() or PrepareGameSyncs(), this value contains the AkUniqueID of the event/game sync that was prepared/unprepared, if the array contained only one element. Otherwise, in_bankID equals AK_INVALID_UNIQUE_ID.
in_pInMemoryBankPtr  Value returned when the unloaded bank was loaded using an in memory location
in_eLoadResult  Result of the requested action.
  • AK_Success: Load or unload successful.
  • AK_IDNotFound: At least one of the event/game sync identifiers passed to PrepareEvent() or PrepareGameSyncs() does not exist.
  • AK_InsufficientMemory: Insufficient memory to store bank data.
  • AK_BankReadError: I/O error.
  • AK_WrongBankVersion: Invalid bank version: make sure the version of Wwise that you used to generate the SoundBanks matches that of the SDK you are currently using.
  • AK_InvalidFile: File specified could not be opened.
  • AK_InvalidParameter: Invalid parameter.
  • AK_Fail: Load or unload failed for any other reason. (Most likely small allocation failure)
in_memPoolId  ID of the memory pool in which the bank was explicitly loaded/unloaded. AK_DEFAULT_POOL_ID is returned whenever this callback is issued from an implicit bank load (PrepareEvent(), PrepareGameSyncs()), the bank memory was managed internally, or an error occurred.
in_pCookie  Optional cookie that was passed to the bank request.
Remarks:
This callback is executed from the bank thread. The processing time in the callback function should be minimal. Having too much processing time could slow down the bank loading process.
See also:

Definition at line 288 of file AkCallback.h.


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