Skip to main content

SetShapeAllocMixBufferCommand

仮想ミックスバッファーを割り当てます。

Syntax

Parameters

command   _Inout_
Type: SHAPE_FLOWGRAPH_COMMAND*
初期化する SHAPE_FLOWGRAPH_COMMAND コマンド。 virtualId   
Type: UINT32
ミックスバッファーの仮想 ID (0 ~ 8191、両端含む)。割り当てる各ミックスバッファーは一意の仮想 ID を持つ必要があります。 numIn   
Type: UINT32
ミックスバッファーへの入力数。この値は、このミックスバッファーに出力する Scalable Hardware Audio Processing Engine (SHAPE) ブロックの数を指定します。 numOut   
Type: UINT32
ミックスバッファーからの出力数。この値は、このミックスバッファーから読み取る SHAPE ブロックの数を指定します。 attenuation   
Type: SHAPE_MIXBUFFER_ATTENUATION
SHAPE_MIXBUFFER_ATTENUATION 列挙体のメンバー。この値は、このミックスバッファーへのすべての入力に適用される dB 単位の減衰量を指定します。

Return value

Type: HRESULT 関数が成功した場合は S_OK を返します。1 つ以上の引数が無効な場合は E_INVALIDARG を返します。

Remarks

すべてのミックスバッファーは単一チャンネル (モノラル) であり、使用前に割り当てる必要があります。物理ミックスバッファーは合計 128 個ですが、仮想ミックスバッファーは 8192 個利用可能です。物理ミックスバッファーは再利用できますが、仮想ミックスバッファーは再利用できません。 実行リストは、ミックスバッファーの割り当てに仮想 ID を使用します。割り当てコマンドが実行されたときのみ、物理ミックスバッファーが指定の仮想 ID にバインドされます。その仮想 ID を使用する後続のコマンドは、割り当てられた物理ミックスバッファーに向けられます。割り当てコマンドは SHAPE プロセッサーからミックスバッファーブロックにディスパッチされ、仮想 ID と物理ミックスバッファーのバインディングを行います。 多くのタイトルはフローグラフを直接実装しません。XAudio2 およびオーディオミドルウェアは SHAPE コンポーネントを暗黙的に実装します。ただし、フローグラフを構築することで、XBOX One 本体のオーディオアクセラレーション機能に対する最大限の柔軟性とアクセスが得られます。

Requirements

Header: shapeflowgraph.h Supported platforms: XBOX One ファミリー本体および XBOX Series 本体

See also

ACP の概要 SHAPE の概要 shapeflowgraph
最終更新日 2026年8月24日