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

> SHAPE_FLOWGRAPH_DMA_COMMAND

# SHAPE\_FLOWGRAPH\_DMA\_COMMAND

指示在混音缓冲区和系统内存之间移动数据。

## 语法

```cpp theme={null}
typedef struct SHAPE_FLOWGRAPH_DMA_COMMAND {  
    UINT64 command : 5;
    UINT64 queued : 1;
    UINT64 disabled : 1;
    UINT64 error : 1;
    UINT64 reserved0 : 5;
    UINT64 write : 1;
    UINT64 mixBuffer : 13;
    UINT64 contextId : 12;
    UINT64 reserved1 : 25;
} SHAPE_FLOWGRAPH_DMA_COMMAND  
```

### 成员

`command`\
类型：UINT64

来自 [SHAPE\_FLOWGRAPH\_COMMAND\_TYPE](/reference/audio/shapeflowgraph/enums/shape_flowgraph_command_type) 的 SHAPE\_FLOWGRAPH\_COMMAND\_TYPE\_DMA 命令。

`queued`\
类型：UINT64

内部处理标志：1 == 已插入内部命令队列；0 == 正在等待。

`disabled`\
类型：UINT64

用于禁用操作的标志。

`error`\
类型：UINT64

命令无效。由音频控制处理器 (ACP) 设置。

`reserved0`\
类型：UINT64

保留。

`write`\
类型：UINT64

1 == 写入；0 == 读取。

`mixBuffer`\
类型：UINT64

输入或输出混音缓冲区。

`contextId`\
类型：UINT64

上下文 ID。

`reserved1`\
类型：UINT64

保留。

## 备注

直接内存访问 (DMA) 命令仅在单个混音缓冲区上运行。为了适应多通道（大于单声道）内容，DMA 支持块偏移。这使 DMA 控制能够以每块为基础将数据与其他 DMA 命令交错。

支持 DMA 读写操作。DMA 命令被分派到 DMA 硬件块以供执行。

对于 DMA 读取操作，输入数据驻留在系统内存中，目标是混音缓冲区。对于 DMA 写入操作，输入数据驻留在混音缓冲区中，目标是系统内存。每个命令对应于 48 KHz 下 128 采样音频帧的单通道输出处理。

## 要求

**标头：** 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)
- [ShapeFlowGraph](/zh-CN/reference/audio/shapeflowgraph/shapeflowgraph_members.md)
- [SHAPE_FLOWGRAPH_COMMAND_TYPE](/zh-CN/reference/audio/shapeflowgraph/enums/shape_flowgraph_command_type.md)
- [SetShapeDmaCommand](/zh-CN/reference/audio/shapeflowgraph/functions/setshapedmacommand.md)
- [ACP_COMMAND_LOAD_SHAPE_FLOWGRAPH](/zh-CN/reference/audio/acphal/structs/acp_command_load_shape_flowgraph.md)