Skip to main content

SHAPE_XMA_CONTEXT

XBOX Media Audio (XMA) 內容。

語法

成員

sizeRead0
類型: UINT32
寫入: 左側輸入緩衝區的大小 (以 2 KB 區塊為單位)。 numLoops
類型: UINT32
讀取/寫入: 迴圈數目。255 表示無限 (連續) 迴圈。 validBuffer
類型: UINT32
讀取/寫入: 輸入緩衝區的有效性旗標。 sizeWrite
類型: UINT32
寫入: 輸出緩衝區的大小 (以 256 位元組區塊為單位)。 offsetWrite
類型: UINT32
讀取: 硬體將寫入的輸出緩衝區位移 (以 256 位元組區塊為單位)。 sizeRead1
類型: UINT32
寫入: 右側輸入緩衝區的大小 (以 2 KB 區塊為單位)。 loopSubframeEnd
類型: UINT32
寫入: 迴圈終點的子框架編號 (包含在內)。 reserved0
類型: UINT32
保留。 loopSubframeSkip
類型: UINT32
寫入: 迴圈開頭要略過的子框架數目。有效值為 0、1、2、3 和 4。 numSubframesToDecode
類型: UINT32
寫入: 每次處理要解碼的子框架數目。有效值為 1、2、4 和 8。 numSubframesToSkip
類型: UINT32
寫入: 要略過的子框架數目。有效值為 0、1、2、3 和 4。 sampleRate
類型: UINT32
寫入: 串流的取樣率。有效值位於 SHAPE_XMA_SAMPLE_RATE 列舉中。 numChannels
類型: UINT32
寫入: 串流中的聲道數目。0 表示單聲道 (一個聲道);1 表示立體聲 (兩個聲道)。 reserved1
類型: UINT32
保留。 validWrite
類型: UINT32
讀取/寫入: 寫入緩衝區的有效性旗標。1 表示硬體可以寫入;0 表示硬體無法寫入。 offsetRead
類型: UINT32
讀取/寫入: 從輸入緩衝區開頭算起的位移 (以位元為單位)。 errorStatus
類型: UINT32
讀取: 一或多個錯誤值。 errorSet
類型: UINT32
讀取: 錯誤旗標。如果未發生錯誤則為 0;如果發生錯誤則為 1。請使用 GetShapeXmaErrorStatus 擷取錯誤值。 loopStartOffset
類型: UINT32
寫入: 從讀取緩衝區指標算起、硬體開始解碼處的位移 (以位元為單位)。 parserErrorStatus
類型: UINT32
讀取: 剖析器錯誤值。 parserErrorSet
類型: UINT32
讀取: 剖析器錯誤旗標。如果未發生錯誤則為 0;如果發生錯誤則為 1。請使用 GetShapeXmaParserErrorStatus 擷取錯誤值。 loopEndOffset
類型: UINT32
寫入: 從讀取緩衝區指標算起、硬體結束解碼處的位移 (以位元為單位)。 packetMetaData
類型: UINT32
保留供內部使用。 currentBuffer
類型: UINT32
讀取/寫入: 目前的輸入緩衝區。0 表示左側緩衝區,1 表示右側緩衝區。 ptrRead0
類型: UINT32
寫入: 左側輸入緩衝區的指標。對齊 2 KB 邊界;會忽略較低的 11 個位元。 ptrRead1
類型: UINT32
寫入: 右側輸入緩衝區的指標。對齊 2 KB 邊界;會忽略較低的 11 個位元。 ptrWrite
類型: UINT32
寫入: 輸出緩衝區的指標。對齊 64 位元組邊界。 ptrOverlapAdd
類型: UINT32
寫入: 工作緩衝區的指標。對齊 128 位元組邊界。 writeBufferOffsetRead
類型: UINT32
寫入: 輸出緩衝區中讀取指標的位移 (以 256 位元組區塊為單位)。 reserved2
類型: UINT32
保留。 stopWhenDone
類型: UINT32
保留供內部使用。 interruptWhenDone
類型: UINT32
保留供內部使用。 reserved
類型: UINT32[6]
保留。

備註

此結構包含 XMA 解碼器區塊的內容。 輸入緩衝區的大小上限為 8 MB。若要判斷輸入緩衝區的使用狀態,請檢查 offsetRead、currentBuffer 和 validBuffer 成員。 標示為 讀取 的成員由音訊控制處理器 (ACP) 程式庫寫入,您的應用程式只應讀取這些成員。標示為 寫入 的成員由您的應用程式設定,ACP 程式庫不會變更。標示為 讀取/寫入 的成員由您的應用程式設定,但 ACP 程式庫可以變更。 如需詳細資訊,請參閱 SHAPE 概觀中的 XMA 一節。

需求

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

概念文件

另請參閱

ShapeXmaContext
Last modified on October 6, 2026