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

# SetShapeDmaAudioBuffer

> SetShapeDmaAudioBuffer

# SetShapeDmaAudioBuffer

Define o buffer de áudio de DMA. Essa é uma função sobrecarregada: uma função aceita um ponteiro virtual e a outra, um endereço físico.

## Sintaxe

```cpp theme={null}
HRESULT SetShapeDmaAudioBuffer(  
         SHAPE_DMA_CONTEXT* context,  
         APU_ADDRESS audioBuffer  
)  
```

### Parâmetros

*context*   \_Inout\_\
Tipo: [SHAPE\_DMA\_CONTEXT\*](/pt-BR/reference/audio/shapedmacontext/structs/shape_dma_context)

Ponteiro para uma estrutura [SHAPE\_DMA\_CONTEXT](/pt-BR/reference/audio/shapedmacontext/structs/shape_dma_context).

*audioBuffer*   \_In\_\
Tipo: APU\_ADDRESS

Endereço físico do buffer.

### Valor retornado

Tipo: HRESULT

Código de êxito ou de erro HRESULT.

## Comentários

Você pode evitar comandos de Direct Memory Access (DMA) bloqueados garantindo que seu 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, garanta que algum múltiplo desses quadros (pelo menos em buffer duplo com oito quadros) esteja no buffer para que o hardware possa gravar à frente do ponteiro de leitura do título. Como alternativa, você poderia forçar 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, consulte [Comandos bloqueados](/pt-BR/build/console-features/audio/overviews/shape-overview#ID4EBGAC) em [Visão geral do SHAPE](/pt-BR/build/console-features/audio/overviews/shape-overview).

## Requisitos

**Cabeçalho:** shapedmacontext.h

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

## Confira também

[ShapeDmaContext](/pt-BR/reference/audio/shapedmacontext/shapedmacontext_members)


## Related topics

- [SetShapeDmaAudioBuffer](/ko/reference/audio/shapedmacontext/functions/setshapedmaaudiobuffer_2.md)
- [SetShapeDmaAudioBuffer function](/reference/audio/shapedmacontext/functions/setshapedmaaudiobuffer.md)
- [SetShapeDmaAudioBuffer 関数](/ja-jp/reference/audio/shapedmacontext/functions/setshapedmaaudiobuffer.md)
- [Función SetShapeDmaAudioBuffer](/es/reference/audio/shapedmacontext/functions/setshapedmaaudiobuffer.md)
- [SetShapeDmaAudioBuffer 函数](/zh-CN/reference/audio/shapedmacontext/functions/setshapedmaaudiobuffer.md)