Skip to main content

ApuCreateHeap

APU ヒープを作成します。

構文

パラメーター

cachedSizeInBytes   _In_
型: UINT32
キャッシュされたメモリ割り当てのサイズ (バイト単位)。 nonCachedSizeInBytes   _In_opt_
型: UINT32
非キャッシュ割り当てのサイズ (バイト単位)。0 の場合は、既定の割り当て (約 1 MB) を使用します。

戻り値

型: HRESULT このメソッドは、他のエラー コードに加えて次の値を返す可能性があります。

解説

APU ヒープは 1 つしか作成できず、プロセスの有効期間中は保持されます。ヒープが解放されるのは、プロセスが終了したときのみです。 必要な要件どおりにヒープが割り当てられるようにするには、他の ACP HAL および APU メソッドの前にこのメソッドを呼び出します。 このメソッドの前に ACP HAL (AcpHal.h) または APU のメソッドが呼び出された場合、64 MB のキャッシュ ヒープと約 1 MB の非キャッシュ ヒープが割り当てられます。その後にこのメソッドを呼び出すと、APU_E_HEAP_ALREADY_ALLOCATED で失敗します。 キャッシュ メモリは、すべての Waves アセットとコマンド/メッセージ キューに使用されます。非キャッシュ メモリは、SHAPE コンテキストと通知に使用されます。

要件

ヘッダー: apu.h ライブラリ: acphal.lib サポート対象プラットフォーム: XBOX One ファミリー本体、XBOX Series 本体

概念ドキュメント

関連項目

APU
最終更新日 2026年8月24日