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

內容識別碼。

`reserved1`\
類型：UINT64

保留。

## 備註

直接記憶體存取 (DMA) 命令只會作用於單一混音緩衝區。為了容納多聲道 (多於單聲道) 內容，DMA 支援區塊位移。這可讓 DMA 控制以每個區塊為單位，將資料與其他 DMA 命令交錯。

支援 DMA 讀取和寫入作業。DMA 命令會分派至 DMA 硬體區塊執行。

對於 DMA 讀取作業，輸入資料位於系統記憶體中，目的地是混音緩衝區。對於 DMA 寫入作業，輸入資料位於混音緩衝區中，目的地是系統記憶體。每個命令對應於 48 KHz 下 128 個取樣音訊框架之單一聲道的輸出處理。

## 需求

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