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 パスあたりにデコードするサブフレーム数。有効な値は 1、2、4、8 です。 numSubframesToSkip
型: UINT32
書き込み: スキップするサブフレーム数。有効な値は 0、1、2、3、4 です。 sampleRate
型: UINT32
書き込み: ストリームのサンプル レート。有効な値は SHAPE_XMA_SAMPLE_RATE 列挙型に含まれます。 numChannels
型: UINT32
書き込み: ストリームのチャネル数。0 はモノラル (1 チャネル)、1 はステレオ (2 チャネル) を指定します。 reserved1
型: UINT32
予約されています。 validWrite
型: UINT32
読み取り/書き込み: 書き込みバッファーの有効性フラグ。1 はハードウェアが書き込み可能であることを示します。0 はハードウェアが書き込めないことを示します。 offsetRead
型: UINT32
読み取り/書き込み: 入力バッファーの先頭からのオフセット (ビット単位)。 errorStatus
型: UINT32
読み取り: 1 つ以上のエラー値。 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 です。入力バッファーの消費状況を確認するには、offsetReadcurrentBuffer、および validBuffer メンバーを調べます。 Read とマークされたメンバーは Audio Control Processor (ACP) ライブラリによって書き込まれるため、アプリケーションからは読み取り専用として扱う必要があります。Write とマークされたメンバーはアプリケーションによって設定され、ACP ライブラリでは変更されません。Read/Write とマークされたメンバーはアプリケーションによって設定されますが、ACP ライブラリによって変更される可能性があります。 詳細については、SHAPE の概要XMA セクションを参照してください。

要件

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

概念ドキュメント

関連項目

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