> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetShapeDmaAudioBuffer

> GetShapeDmaAudioBuffer

# GetShapeDmaAudioBuffer

Obtém o buffer de áudio de DMA (Acesso Direto à Memória).

## Sintaxe

```cpp theme={null}
void* GetShapeDmaAudioBuffer(  
         const SHAPE_DMA_CONTEXT* context  
)  
```

### Parâmetros

*context*   \_In\_\
Tipo: [SHAPE\_DMA\_CONTEXT\*](https://docs.xbox.com/pt-BR/reference/audio/shapedmacontext/structs/shape_dma_context.md)

Ponteiro para uma estrutura [SHAPE\_DMA\_CONTEXT](https://docs.xbox.com/pt-BR/reference/audio/shapedmacontext/structs/shape_dma_context.md).

### Valor de retorno

Tipo: void\*

Retorna um ponteiro para o buffer de áudio.

## Comentários

Você pode evitar comandos de DMA bloqueados garantindo que o buffer de áudio seja suficientemente grande e que os dados sejam transmitidos em intervalos regulares (relacionados ao tamanho do buffer). Por exemplo, se você estiver transmitindo quatro quadros de hardware por vez, verifique se algum múltiplo desses quadros (pelo menos em buffer duplo, com oito quadros) está no buffer para que o hardware possa gravar à frente do ponteiro de leitura do título. Como alternativa, você pode impor o esvaziamento do buffer antes de enviar o próximo grafo de fluxo (consumir, atualizar o ponteiro de leitura de DMA e, em seguida, enviar o grafo de fluxo). Para obter mais detalhes, confira [Comandos bloqueados](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/shape-overview.md#ID4EBGAC) em [Visão geral do SHAPE](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/shape-overview.md).

## Requisitos

**Cabeçalho:** shapedmacontext.h

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[ShapeDmaContext](https://docs.xbox.com/pt-BR/reference/audio/shapedmacontext/shapedmacontext_members.md)


## Related topics

- [ShapeDmaContext](https://docs.xbox.com/pt-BR/reference/audio/shapedmacontext/shapedmacontext_members.md)
- [GetShapeDmaBufferFull](https://docs.xbox.com/pt-BR/reference/audio/shapedmacontext/functions/getshapedmabufferfull.md)
- [SetShapeDmaAudioBuffer](https://docs.xbox.com/pt-BR/reference/audio/shapedmacontext/functions/setshapedmaaudiobuffer_2.md)
- [Função SetShapeDmaAudioBuffer](https://docs.xbox.com/pt-BR/reference/audio/shapedmacontext/functions/setshapedmaaudiobuffer.md)
- [GetShapeDmaMixBufferPeakMagnitude](https://docs.xbox.com/pt-BR/reference/audio/shapedmacontext/functions/getshapedmamixbufferpeakmagnitude.md)