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

Indica que os dados devem ser movidos entre um buffer de mixagem e a memória do sistema.

## Sintaxe

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

### Membros

`command`\
Tipo: UINT64

O comando SHAPE\_FLOWGRAPH\_COMMAND\_TYPE\_DMA de [SHAPE\_FLOWGRAPH\_COMMAND\_TYPE](/pt-BR/reference/audio/shapeflowgraph/enums/shape_flowgraph_command_type).

`queued`\
Tipo: UINT64

Sinalizador de processo interno: 1 == inserido na fila de comandos interna; 0 == aguardando.

`disabled`\
Tipo: UINT64

Sinalizador para desabilitar a operação.

`error`\
Tipo: UINT64

O comando é inválido. Definido pelo ACP (Audio Control Processor).

`reserved0`\
Tipo: UINT64

Reservado.

`write`\
Tipo: UINT64

1 == gravação; 0 == leitura.

`mixBuffer`\
Tipo: UINT64

O buffer de mixagem de entrada ou saída.

`contextId`\
Tipo: UINT64

ID do contexto.

`reserved1`\
Tipo: UINT64

Reservado.

## Comentários

O comando DMA (Direct Memory Access) opera apenas em um único buffer de mixagem. Para acomodar conteúdo multicanal (mais que mono), o DMA dá suporte a deslocamentos de bloco. Isso permite que o controle DMA intercale os dados com outros comandos DMA por bloco.

Há suporte para operações de leitura e gravação de DMA. O comando DMA é despachado para o bloco de hardware DMA para execução.

Para operações de leitura de DMA, os dados de entrada residem na memória do sistema e o destino é um buffer de mixagem. Para operações de gravação de DMA, os dados de entrada residem em um buffer de mixagem e o destino é a memória do sistema. Cada comando corresponde ao processamento de saída de um único canal de um quadro de áudio de 128 amostras a 48 KHz.

## Requisitos

**Cabeçalho:** shapeflowgraph.h

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[Visão geral do ACP](/pt-BR/build/console-features/audio/overviews/acp-overview)

[Visão geral do SHAPE](/pt-BR/build/console-features/audio/overviews/shape-overview)

[shapeflowgraph](/pt-BR/reference/audio/shapeflowgraph/shapeflowgraph_members)


## Related topics

- [SHAPE_FLOWGRAPH_COMMAND](/pt-BR/reference/audio/shapeflowgraph/structs/shape_flowgraph_command.md)
- [ShapeFlowGraph](/pt-BR/reference/audio/shapeflowgraph/shapeflowgraph_members.md)
- [SHAPE_FLOWGRAPH_COMMAND_TYPE](/pt-BR/reference/audio/shapeflowgraph/enums/shape_flowgraph_command_type.md)
- [SetShapeDmaCommand](/pt-BR/reference/audio/shapeflowgraph/functions/setshapedmacommand.md)
- [ACP_COMMAND_LOAD_SHAPE_FLOWGRAPH](/pt-BR/reference/audio/acphal/structs/acp_command_load_shape_flowgraph.md)