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

# Función SetShapeDmaAudioBuffer

> Función SetShapeDmaAudioBuffer

# Función SetShapeDmaAudioBuffer

Establece el búfer de audio DMA. Se trata de una función sobrecargada: una función acepta un puntero virtual y la otra, una dirección física.

## Sintaxis

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

### Parámetros

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

Puntero a una estructura [SHAPE\_DMA\_CONTEXT](/reference/audio/shapedmacontext/structs/shape_dma_context).

*audioBuffer*   \_In\_\
Tipo: void\*

Puntero al búfer de audio.

### Valor devuelto

Tipo: HRESULT

Código HRESULT de éxito o de error.

## Comentarios

Puede evitar los comandos de acceso directo a memoria (DMA) bloqueados asegurándose de que el búfer de audio sea lo suficientemente grande y de que los datos se transmitan a intervalos regulares (en relación con el tamaño del búfer). Por ejemplo, si transmite cuatro fotogramas de hardware a la vez, asegúrese de que en el búfer haya algún múltiplo de esos fotogramas (al menos con doble búfer, es decir, ocho fotogramas) para que el hardware pueda escribir por delante del puntero de lectura del título. Como alternativa, podría exigir el vaciado del búfer antes de enviar el siguiente grafo de flujo (consumir, actualizar el puntero de lectura de DMA y, a continuación, enviar el grafo de flujo). Para obtener más detalles, consulte [Comandos bloqueados](/build/console-features/audio/overviews/shape-overview#ID4EBGAC) en [Información general sobre SHAPE](/build/console-features/audio/overviews/shape-overview).

## Requisitos

**Encabezado:** shapedmacontext.h

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[ShapeDmaContext](/reference/audio/shapedmacontext/shapedmacontext_members)


## Related topics

- [ShapeDmaContext](/es/reference/audio/shapedmacontext/shapedmacontext_members.md)
- [SetShapeDmaAudioBuffer](/es/reference/audio/shapedmacontext/functions/setshapedmaaudiobuffer_2.md)
- [Función SetShapePcmAudioBuffer](/es/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer.md)
- [SetShapeDmaBufferFull](/es/reference/audio/shapedmacontext/functions/setshapedmabufferfull.md)
- [SetShapePcmAudioBuffer](/es/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer_2.md)