> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SetShapeAllocMixBufferCommand

> SetShapeAllocMixBufferCommand

# SetShapeAllocMixBufferCommand

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

## Syntax

```cpp theme={null}
HRESULT SetShapeAllocMixBufferCommand(  
         SHAPE_FLOWGRAPH_COMMAND* command,  
         UINT32 virtualId,  
         UINT32 numIn,  
         UINT32 numOut,  
         SHAPE_MIXBUFFER_ATTENUATION attenuation  
)  
```

### Parameters

*command*   \_Inout\_\
Type: SHAPE\_FLOWGRAPH\_COMMAND\*

初期化する [SHAPE\_FLOWGRAPH\_COMMAND](/reference/audio/shapeflowgraph/structs/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](/reference/audio/shapeflowgraph/enums/shape_mixbuffer_attenuation) 列挙体のメンバー。この値は、このミックスバッファーへのすべての入力に適用される dB 単位の減衰量を指定します。

### Return value

Type: HRESULT

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

## Remarks

すべてのミックスバッファーは単一チャンネル (モノラル) であり、使用前に割り当てる必要があります。物理ミックスバッファーは合計 128 個ですが、仮想ミックスバッファーは 8192 個利用可能です。物理ミックスバッファーは再利用できますが、仮想ミックスバッファーは再利用できません。

実行リストは、ミックスバッファーの割り当てに仮想 ID を使用します。割り当てコマンドが実行されたときのみ、物理ミックスバッファーが指定の仮想 ID にバインドされます。その仮想 ID を使用する後続のコマンドは、割り当てられた物理ミックスバッファーに向けられます。割り当てコマンドは SHAPE プロセッサーからミックスバッファーブロックにディスパッチされ、仮想 ID と物理ミックスバッファーのバインディングを行います。

多くのタイトルはフローグラフを直接実装しません。[XAudio2](/build/console-features/audio/overviews/xma2-overview) およびオーディオミドルウェアは SHAPE コンポーネントを暗黙的に実装します。ただし、フローグラフを構築することで、XBOX One 本体のオーディオアクセラレーション機能に対する最大限の柔軟性とアクセスが得られます。

## Requirements

**Header:** shapeflowgraph.h

**Supported platforms:** XBOX One ファミリー本体および XBOX Series 本体

## See also

[ACP の概要](/build/console-features/audio/overviews/acp-overview)

[SHAPE の概要](/build/console-features/audio/overviews/shape-overview)

[shapeflowgraph](/reference/audio/shapeflowgraph/shapeflowgraph_members)


## Related topics

- [SHAPE_FLOWGRAPH_COMMAND_TYPE](/ja-jp/reference/audio/shapeflowgraph/enums/shape_flowgraph_command_type.md)
- [ShapeFlowGraph](/ja-jp/reference/audio/shapeflowgraph/shapeflowgraph_members.md)
- [SHAPE_FLOWGRAPH_ALLOC_MIXBUFFER_COMMAND](/ja-jp/reference/audio/shapeflowgraph/structs/shape_flowgraph_alloc_mixbuffer_command.md)
- [SHAPE_FLOWGRAPH_COMMAND](/ja-jp/reference/audio/shapeflowgraph/structs/shape_flowgraph_command.md)
- [SetShapeSrcCommand function](/ja-jp/reference/audio/shapeflowgraph/functions/shapeflowgraph_setshapesrccommand.md)