Skip to main content

SetShapeDmaAudioBuffer

DMA オーディオ バッファーを設定します。これはオーバーロードされた関数です。一方の関数は仮想ポインターを受け取り、もう一方は物理アドレスを受け取ります。

構文

パラメーター

context   _Inout_
型: SHAPE_DMA_CONTEXT*
SHAPE_DMA_CONTEXT 構造体へのポインター。 audioBuffer   _In_
型: APU_ADDRESS
バッファーの物理アドレス。

戻り値

型: HRESULT HRESULT の成功またはエラー コード。

解説

オーディオ バッファーが十分に大きく、データがバッファー サイズに応じた一定間隔でストリーミングされるようにすることで、Direct Memory Access (DMA) コマンドのブロックを防ぐことができます。たとえば、一度に 4 個のハードウェア フレームをストリーミングしている場合、そのフレームの倍数 (少なくとも 8 フレームでダブル バッファリング) をバッファーに確保し、タイトルの読み取りポインターより先行してハードウェアが書き込めるようにしてください。あるいは、次のフローグラフを送信する前にバッファーを空にすること (消費、DMA 読み取りポインターの更新、その後フローグラフの送信) を強制することもできます。詳細については、SHAPE の概要Blocked commands を参照してください。

要件

ヘッダー: shapedmacontext.h サポートされるプラットフォーム: XBOX One ファミリ本体および XBOX Series 本体

関連項目

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