> ## 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

配置虛擬混音緩衝區。

## 語法

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

### 參數

*command*   \_Inout\_\
類型：SHAPE\_FLOWGRAPH\_COMMAND\*

要初始化的 [SHAPE\_FLOWGRAPH\_COMMAND](/zh-TW/reference/audio/shapeflowgraph/structs/shape_flowgraph_command) 命令。

*virtualId*   \
類型：UINT32

混音緩衝區的虛擬識別碼，範圍為 0 到 8191 (含)。每個已配置的混音緩衝區都必須有唯一的虛擬識別碼。

*numIn*   \
類型：UINT32

混音緩衝區的輸入數目。此值指定將輸出至此混音緩衝區的可調整硬體音訊處理引擎 (SHAPE) 區塊數目。

*numOut*   \
類型：UINT32

混音緩衝區的輸出數目。此值指定將從此混音緩衝區讀取的 SHAPE 區塊數目。

*attenuation*   \
類型：SHAPE\_MIXBUFFER\_ATTENUATION

[SHAPE\_MIXBUFFER\_ATTENUATION](/zh-TW/reference/audio/shapeflowgraph/enums/shape_mixbuffer_attenuation) 列舉的其中一個成員。此值指定套用至此混音緩衝區所有輸入的 dB 衰減。

### 傳回值

類型：HRESULT

如果函式成功，會傳回 `S_OK`。如果一或多個引數無效，函式會傳回 `E_INVALIDARG`。

## 備註

所有混音緩衝區都是單一聲道 (單聲道)，且必須在使用前配置。雖然實體混音緩衝區總共有 128 個，但可用的虛擬混音緩衝區有 8192 個。實體混音緩衝區可以重複使用，但虛擬混音緩衝區則不行。

執行清單會使用虛擬識別碼來指派混音緩衝區。只有在執行配置命令時，實體混音緩衝區才會繫結至指定的虛擬識別碼。後續使用該虛擬識別碼的命令會導向至已配置的實體混音緩衝區。配置命令會從 SHAPE 處理器分派至混音緩衝區區塊，由該區塊執行虛擬識別碼與實體混音緩衝區的繫結。

許多遊戲並不會直接實作流程圖。[XAudio2](/zh-TW/build/console-features/audio/overviews/xma2-overview) 和音訊中介軟體會隱含地實作 SHAPE 元件。不過，建構流程圖能提供最大的彈性，並可存取 XBOX One 主機的音訊加速功能。

## 需求

**標頭：** shapeflowgraph.h

**支援的平台：** XBOX One 系列主機與 XBOX Series 主機

## 另請參閱

[ACP 概觀](/zh-TW/build/console-features/audio/overviews/acp-overview)

[SHAPE 概觀](/zh-TW/build/console-features/audio/overviews/shape-overview)

[shapeflowgraph](/zh-TW/reference/audio/shapeflowgraph/shapeflowgraph_members)


## Related topics

- [SHAPE_FLOWGRAPH_COMMAND_TYPE](/zh-TW/reference/audio/shapeflowgraph/enums/shape_flowgraph_command_type.md)
- [ShapeFlowGraph](/zh-TW/reference/audio/shapeflowgraph/shapeflowgraph_members.md)
- [SHAPE_FLOWGRAPH_ALLOC_MIXBUFFER_COMMAND](/zh-TW/reference/audio/shapeflowgraph/structs/shape_flowgraph_alloc_mixbuffer_command.md)
- [SHAPE_FLOWGRAPH_COMMAND](/zh-TW/reference/audio/shapeflowgraph/structs/shape_flowgraph_command.md)
- [SetShapeEqCompCommand](/zh-TW/reference/audio/shapeflowgraph/functions/setshapeeqcompcommand.md)