バージョン

menu_open
Wwise SDK 2019.2.15

◆ PrepareEvent() [3/4]

AKSOUNDENGINE_API AKRESULT AK::SoundEngine::PrepareEvent ( PreparationType  in_PreparationType,
const char **  in_ppszString,
AkUInt32  in_uNumEvent 
)

Prepares or unprepares events synchronously.
The Events are identified by strings and converted to IDs internally (refer to 概説 for a discussion on using strings and IDs). Before invoking PrepareEvent(), use LoadBank() to explicitly load the SoundBank(s) that contain the Events and structures. When a request is posted to the Bank Manager consumer thread, it will resolve all dependencies needed to successfully post the specified Events and load the required loose media files.

注釈: Before version 2015.1, the required media files could be included in a separate media SoundBank. As described in 重要な移行の注意 2015.1, however, PrepareEvent() now only looks for loose media files.

The function returns when the request is completely processed.

戻り値
  • AK_Success: Prepare/un-prepare successful.
  • AK_IDNotFound: At least one of the event/game sync identifiers passed to PrepareEvent() 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, invalid memory alignment.
  • AK_Fail: Load or unload failed for any other reason. (Most likely small allocation failure)
注釈
Whenever at least one event fails to be resolved, the actions performed for all other events are cancelled.
注釈: The use of PrepareEvent is incompatible with LoadBank, using in-memory data.
参照
引数
in_PreparationType Preparation type ( Preparation_Load or Preparation_Unload )
in_ppszString Array of event names
in_uNumEvent Number of events in the array

このページはお役に立ちましたか?

サポートは必要ですか?

ご質問や問題、ご不明点はございますか?お気軽にお問い合わせください。

サポートページをご確認ください

あなたのプロジェクトについて教えてください。ご不明な点はありませんか。

プロジェクトを登録していただくことで、ご利用開始のサポートをいたします。

Wwiseからはじめよう