Loads a bank asynchronously (from in-memory data, in-place).
IMPORTANT: Banks loaded from memory with in-place data MUST be unloaded using the UnloadBank function providing the same memory pointer. Make sure you are using the correct UnloadBank(...) overload
Use LoadBankMemoryView when you want to manage I/O on your side. Load the bank file in a buffer and pass its address to the sound engine. In-memory loading is in-place: *** the memory must be valid until the bank is unloaded. *** A bank load request will be posted to the Bank Manager consumer thread. The function returns immediately.
- 返回
- AK_Success if the scheduling was successful, AK_Fail otherwise, or AK_InvalidParameter if memory alignment is not correct. Use a callback to be notified when completed, and get the status of the request. The bank ID, which is obtained by hashing the bank name (see GetIDFromString()). You may use this ID with UnloadBank().
- 参见
- 参数
-
in_pInMemoryBankPtr |
Pointer to the in-memory bank to load (pointer is stored in sound engine, memory must remain valid) |
in_uInMemoryBankSize |
Size of the in-memory bank to load |
in_pfnBankCallback |
Callback function |
in_pCookie |
Callback cookie |
out_bankID |
Returned bank ID |