SetShapeDmaReadPointer

Direct Memory Access (DMA) 読み取りポインターを設定します。

構文

HRESULT SetShapeDmaReadPointer(  
         SHAPE_DMA_CONTEXT* context,  
         UINT32 readPointer  
)  

パラメーター

context _Inout_
型: SHAPE_DMA_CONTEXT* SHAPE_DMA_CONTEXT 構造体へのポインター。 readPointer
型: UINT32 フレーム単位 (128 サンプルブロック) で表される、読み取りポインターの値。

戻り値

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

解説

DMA バッファーのサイズは次の式で計算できます。

fullBufferSizeInBytes = 128 * 4 * numChannels * numFrames

読み取りポインターと書き込みポインターは次のようにインクリメントされます。

readPointer = (readPointer + 1) % numFrames 

writePointer = (writePointer + 1) % numFrames  

オーディオバッファー内のアドレスは次のように計算します。

readAddress = audioBuffer + (128 * 4 * ((readPointer * numChannels) + channel))   

writeAddress = audioBuffer + (128 * 4 * ((writePointer * numChannels) + channel))  

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

要件

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

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

SetShapeDmaReadPointer

SetShapeDmaReadPointer

構文

パラメーター

戻り値

解説

要件

関連項目

​SetShapeDmaReadPointer

​構文

​パラメーター

​戻り値

​解説

​要件

​関連項目

SetShapeDmaReadPointer

構文

パラメーター

戻り値

解説

要件

関連項目