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

Définit le tampon audio DMA. Il s'agit d'une fonction surchargée : l'une accepte un pointeur virtuel, l'autre une adresse physique.

## Syntaxe

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

### Paramètres

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

Pointeur vers une structure [SHAPE\_DMA\_CONTEXT](/fr/reference/audio/shapedmacontext/structs/shape_dma_context).

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

Adresse physique du tampon.

### Valeur renvoyée

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

Vous pouvez éviter le blocage des commandes d'accès direct à la mémoire (DMA) en veillant à ce que votre tampon audio soit suffisamment grand et à ce que les données soient diffusées à intervalles réguliers (en fonction de la taille du tampon). Par exemple, si vous diffusez quatre trames matérielles à la fois, assurez-vous qu'un multiple de ces trames (au moins un double tampon de huit trames) se trouve dans le tampon afin que le matériel puisse écrire en avance sur le pointeur de lecture du titre. Vous pouvez également imposer le vidage du tampon avant de soumettre le flowgraph suivant (consommer, mettre à jour le pointeur de lecture DMA, puis soumettre le flowgraph). Pour plus de détails, consultez [Commandes bloquées](/fr/build/console-features/audio/overviews/shape-overview#ID4EBGAC) dans [Vue d'ensemble de SHAPE](/fr/build/console-features/audio/overviews/shape-overview).

## Configuration requise

**En-tête :** shapedmacontext.h

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

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


## Related topics

- [Fonction SetShapeDmaAudioBuffer](/fr/reference/audio/shapedmacontext/functions/setshapedmaaudiobuffer.md)
- [ShapeDmaContext](/fr/reference/audio/shapedmacontext/shapedmacontext_members.md)
- [SetShapeDmaBufferFull](/fr/reference/audio/shapedmacontext/functions/setshapedmabufferfull.md)
- [GetShapeDmaAudioBuffer](/fr/reference/audio/shapedmacontext/functions/getshapedmaaudiobuffer.md)
- [SetShapePcmAudioBuffer](/fr/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer_2.md)
