> ## 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](/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

虚拟 ID，范围从 0 到 8191。最多有 8192 个虚拟混音缓冲区。

`attenuate`\
类型：UINT64

衰减：0 == 无；所有其他值表示输入数据要移位的位数。有关应用于混音缓冲区的衰减信息，请参阅 [SHAPE\_MIXBUFFER\_ATTENUATION](/reference/audio/shapeflowgraph/enums/shape_mixbuffer_attenuation)。

`reserved1`\
类型：UINT64

保留。

## 备注

执行列表在混音缓冲区分配时使用虚拟 ID。只有在执行分配命令时，物理混音缓冲区才会绑定到指定的虚拟 ID。使用指定虚拟 ID 的后续命令将被导向已分配的物理混音缓冲区。分配命令从可伸缩硬件音频处理引擎 (SHAPE) 处理器分派到混音缓冲区块，在此将虚拟 ID 绑定到物理混音缓冲区。

## 要求

**标头：** shapeflowgraph.h

**支持的平台：** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[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](/zh-CN/reference/audio/shapeflowgraph/structs/shape_flowgraph_command.md)
- [SHAPE_FLOWGRAPH_COMMAND_TYPE](/zh-CN/reference/audio/shapeflowgraph/enums/shape_flowgraph_command_type.md)
- [ShapeFlowGraph](/zh-CN/reference/audio/shapeflowgraph/shapeflowgraph_members.md)
- [SetShapeAllocMixBufferCommand](/zh-CN/reference/audio/shapeflowgraph/functions/setshapeallocmixbuffercommand.md)
- [SHAPE_FLOWGRAPH_DMA_COMMAND](/zh-CN/reference/audio/shapeflowgraph/structs/shape_flowgraph_dma_command.md)