Wwiseサウンドエンジンのすべてのモジュールは、AK::MemoryMgr インターフェイスを介してメモリにアクセスします。サウンドエンジンクライアントによって、このインターフェイスの初期化および終了が行われます。

デフォルト実装は、静的ライブラリ（AkMemoryMgr.lib）としてSDKで提供されています。このライブラリを使うには、クライアントは、 AkModule.h ヘッダを含めて、 AK::MemoryMgr::Init の初期化関数をコールする必要があります。

AkMemoryMgr.libとその他ライブラリの使用に関する詳細は ビルド構成 を参照してください。

初期化

デフォルト実装では、デフォルトの初期化設定を AK::MemoryMgr::GetDefaultSettings を使い取得できます。

Memory Managerによって割り当てられるバーチャルメモリやデバイスメモリの合計を制限するには、以下の設定を使います:

• AkMemSettings::uMemAllocationSizeLimit

デバグ用のアロケーションをトラッキングするには、以下の設定を使います（リリース用コンフィギュレーションでは、これらはコールされません）:

• AkMemSettings::pfDebugMalloc
• AkMemSettings::pfDebugMalign
• AkMemSettings::pfDebugRealloc
• AkMemSettings::pfDebugFree
• AkMemSettings::pfDebugFalign
• AkMemSettings::pfDebugCheckForOverwrite

上記のデバグ関数は、下記の実際のアロケーション関数を置き換えるものではなく、様々なメモリアロケーションイベントの、通知コールバックです。

以下を使えば、rpmallocを使ったデフォルト実装をオーバーライドし、カスタムアロケータを設定できます。

• AkMemSettings::pfInitForThread
• AkMemSettings::pfTermForThread
• AkMemSettings::pfMalloc
• AkMemSettings::pfMalign
• AkMemSettings::pfRealloc
• AkMemSettings::pfFree
• AkMemSettings::pfFalign
• AkMemSettings::pfTotalReservedMemorySize
• AkMemSettings::pfSizeOfMemory

上記のアロケーション関数が、 AkMemType_Device ビットを尊重し、ビットが設定されたらデバイスメモリを返すことが重要です。デバイスのメモリアロケーションは、一部のプラットフォームでしか使われていなく、具体的なパラメータに準拠する必要があるので、詳しくはプラットフォーム別のセクションを参照してください。

PS5では、デバイスメモリページを追加フラグで保護して返すことが重要です。PS5で正しくデバイスメモリアロケーション関数を実装する方法については、 メモリマッピング要件 を参照してください。

Xbox Oneでは、APU関数でアロケーションしたメモリページを返すことが重要です。Xbox Oneで正しくデバイスメモリアロケーション関数を実装する方法については、 APU メモリ を参照してください。

Xbox Series Xでは、APU関数でアロケーションしたメモリページを返すことが重要です。Xbox Series Xで正しくデバイスメモリアロケーション関数を実装する方法については、 APU メモリ を参照してください。

以下を使えば、rpmallocの根底にあるページアロケーション方式をオーバーライドできます:

• AkMemSettings::pfAllocVM
• AkMemSettings::pfFreeVM
• AkMemSettings::pfAllocDevice
• AkMemSettings::pfFreeDevice
• AkMemSettings::uVMPageSize
• AkMemSettings::uDevicePageSize

rpmallocをオーバーライドするために、カスタムアロケータを設定した場合は、上記関数はコールされません。デバイスのメモリアロケーションは、一部のプラットフォームでしか使われていなく、具体的なパラメータに準拠する必要があるので、詳しくはプラットフォーム別のセクションを参照してください。返されるメモリのアライメントが、プラットフォームの本来のアライメント（例えば、Windowsであれば64KB）に合致しない場合は、そのカスタムアライメントを、uVMPageSizeやuDevicePageSizeで指定する必要があります。

ゲームのメモリマネージャ初期化に関するサンプルコードと詳細は サンプル をご覧ください。

サウンドバンクのメモリ使用に関する詳細は、 バンクのロード を参照してください。

メモリアロケーションの最適化に関する詳細は、 メモリアロケーションの最適化 を参照してください。

メモリマネージャのオーバーライド

クライアントは、 AK::MemoryMgr のインターフェースのカスタム化された実装を提供することができます。 AkMemoryMgr.h で定義されている関数は、すべて実装してください。 AkModule.h で定義された AK::MemoryMgr ネームスペースの関数は、メモリマネージャのデフォルト実装のためのものなので、実装する必要はありません。

AkMemSettings の様々なアロケーション関数をオーバーライドするときと同様に、新しい AK::MemoryMgr の実装をプログラミングするときは、ビットが設定されたらデバイスメモリを返すことで、 AkMemType_Device ビットを尊重することが、重要です。デバイスのメモリアロケーションは、一部のプラットフォームでしか使われていなく、具体的なパラメータに準拠する必要があるので、詳しくはプラットフォーム別のセクションを参照してください。