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

# SHAPE_FLOWGRAPH_ALLOC_MIXBUFFER_COMMAND

> SHAPE_FLOWGRAPH_ALLOC_MIXBUFFER_COMMAND

# SHAPE\_FLOWGRAPH\_ALLOC\_MIXBUFFER\_COMMAND

配置實體混音緩衝區以供後續使用。

## 語法

```cpp theme={null}
typedef struct SHAPE_FLOWGRAPH_ALLOC_MIXBUFFER_COMMAND {  
    UINT64 command : 5;
    UINT64 queued : 1;
    UINT64 disabled : 1;
    UINT64 error : 1;
    UINT64 reserved0 : 5;
    UINT64 numIn : 10;
    UINT64 numOut : 10;
    UINT64 virtualId : 13;
    UINT64 attenuate : 3;
    UINT64 reserved1 : 15;
} SHAPE_FLOWGRAPH_ALLOC_MIXBUFFER_COMMAND  
```

### 成員

`command`\
類型：UINT64

來自 [SHAPE\_FLOWGRAPH\_COMMAND\_TYPE](/zh-TW/reference/audio/shapeflowgraph/enums/shape_flowgraph_command_type) 的 SHAPE\_FLOWGRAPH\_COMMAND\_TYPE\_ALLOCMIXBUFFER 命令。

`queued`\
類型：UINT64

內部處理旗標：1 == 已插入內部命令佇列；0 == 等待中。

`disabled`\
類型：UINT64

用於停用命令的旗標：1 == 已停用 (不處理)；0 == 已啟用 (正常處理)。

`error`\
類型：UINT64

命令無效。由音訊控制處理器 (ACP) 設定。

`reserved0`\
類型：UINT64

保留。

`numIn`\
類型：UINT64

輸入數目。在所有輸入完成之前，混音緩衝區不會輸出任何內容。

`numOut`\
類型：UINT64

輸出數目。在所有輸出完成之前，混音緩衝區不會被釋放。

`virtualId`\
類型：UINT64

虛擬識別碼，範圍為 0 到 8191。虛擬混音緩衝區最多有 8192 個。

`attenuate`\
類型：UINT64

衰減：0 == 無；其他所有值表示輸入資料要位移的位元數。如需套用至混音緩衝區之衰減的相關資訊，請參閱 [SHAPE\_MIXBUFFER\_ATTENUATION](/zh-TW/reference/audio/shapeflowgraph/enums/shape_mixbuffer_attenuation)。

`reserved1`\
類型：UINT64

保留。

## 備註

執行清單會使用虛擬識別碼來指派混音緩衝區。只有在執行配置命令時，實體混音緩衝區才會繫結至指定的虛擬識別碼。後續使用該虛擬識別碼的命令會導向至已配置的實體混音緩衝區。配置命令會從可調整硬體音訊處理引擎 (SHAPE) 處理器分派至混音緩衝區區塊，並在該處將虛擬識別碼繫結至實體混音緩衝區。

## 需求

**標頭：** 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_ALLOC_MIXBUFFER_COMMAND](/reference/audio/shapeflowgraph/structs/shape_flowgraph_alloc_mixbuffer_command.md)
- [SHAPE_FLOWGRAPH_COMMAND](/reference/audio/shapeflowgraph/structs/shape_flowgraph_command.md)