Skip to main content

​
IncrementShapeDmaReadPointer

読み取りポインターをインクリメントします。

​
構文

​
パラメーター

context   _Inout_
型: SHAPE_DMA_CONTEXT* SHAPE_DMA_CONTEXT 構造体へのポインター。

​
戻り値

型: void

​
解説

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

​
要件

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

​
関連項目

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

関連トピック

ShapeDmaContextIncrementShapeDmaWritePointerSetShapeDmaReadPointerGetShapeDmaReadPointerACP_COMMAND_INCREMENT_DMA_POINTER