Skip to main content

SHAPE_DMA_CONTEXT

直接記憶體存取 (DMA) 內容結構。

語法

成員

timestamp
類型: UINT32
讀取: 內容處理完成的時間戳記。 reserved0
類型: UINT32
保留。 mixBufPeakMag
類型: UINT32
讀取: 輸出混音緩衝區的峰值大小。 peakMag
類型: UINT32
讀取: 輸出的峰值大小。 readPointer
類型: UINT32
讀取/寫入: 從緩衝區開頭算起的讀取指標,以每個聲道的框架數或框架交錯群組為單位。 reserved1
類型: UINT32
保留。 writePointer
類型: UINT32
讀取/寫入: 從緩衝區開頭算起的寫入指標,以每個聲道的框架數或框架交錯群組為單位。 reserved2
類型: UINT32
保留。 full
類型: UINT32
讀取/寫入: 當讀取指標與寫入指標相等時,full 會指出緩衝區是空的還是已滿 (0 == 空的,1 == 已滿)。 reserved3
類型: UINT32
保留。 reserved4
類型: UINT32
保留。 address
類型: UINT32
寫入: 緩衝區位址,對齊 128 個樣本。 numFrames
類型: UINT32
寫入: numFrames + 1 等於每個聲道的框架數,或系統記憶體 DMA 緩衝區中框架交錯群組的數目。值為零表示一個框架。DMA 區塊可以從這項資訊推導出 DMA 循環緩衝區的大小。此欄位會在定義內容和緩衝區時設定。 reserved5
類型: UINT32
保留。 floatConvert
類型: UINT32
寫入: 如果資料要轉換為浮點數或從浮點數轉換,則為 1。如果資料是 32 位元整數,則為 0。 reserved6
類型: UINT32
保留。 numChannels
類型: UINT32
寫入: numChannels + 1 是緩衝區中音訊的聲道數目。值為零表示一個聲道。 reserved7
類型: UINT32
保留。 channel
類型: UINT32
寫入: 要讀取/寫入的聲道。 reserved8
類型: UINT32
保留。

備註

標示為 Read (讀取) 的成員由 ACP 程式庫寫入,您的應用程式只應讀取這些成員。標示為 Write (寫入) 的成員由您的應用程式設定,ACP 程式庫不會變更。標示為 Read/Write (讀取/寫入) 的成員由您的應用程式設定,但可由 ACP 程式庫變更。 如需流程圖的相關資訊,請參閱 ACP 概觀中的流程圖剖析。

需求

標頭: shapedmacontext.h 支援的平台: XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

ShapeDmaContext
Last modified on October 6, 2026