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

> SHAPE_DMA_CONTEXT

# SHAPE\_DMA\_CONTEXT

Structure de contexte d'accès direct à la mémoire (DMA).

## Syntaxe

```cpp theme={null}
typedef struct SHAPE_DMA_CONTEXT {  
    UINT32 timestamp : 21;
    UINT32 reserved0 : 3;
    UINT32 mixBufPeakMag : 4;
    UINT32 peakMag : 4;
    UINT32 readPointer : 5;
    UINT32 reserved1 : 3;
    UINT32 writePointer : 5;
    UINT32 reserved2 : 3;
    UINT32 full : 1;
    UINT32 reserved3 : 15;
    UINT32 reserved4 : 9;
    UINT32 address : 23;
    UINT32 numFrames : 5;
    UINT32 reserved5 : 3;
    UINT32 floatConvert : 1;
    UINT32 reserved6 : 7;
    UINT32 numChannels : 3;
    UINT32 reserved7 : 5;
    UINT32 channel : 3;
    UINT32 reserved8 : 5;
} SHAPE_DMA_CONTEXT  
```

### Membres

*timestamp*\
Type : UINT32

Lecture : horodatage de la fin du traitement du contexte.

*reserved0*\
Type : UINT32

Réservé.

*mixBufPeakMag*\
Type : UINT32

Lecture : magnitude de crête du tampon de mixage de sortie.

*peakMag*\
Type : UINT32

Lecture : magnitude de crête de la sortie.

*readPointer*\
Type : UINT32

Lecture/Écriture : pointeur de lecture à partir du début du tampon, en unités de trames par canal ou de groupes d'entrelacement de trames.

*reserved1*\
Type : UINT32

Réservé.

*writePointer*\
Type : UINT32

Lecture/Écriture : pointeur d'écriture à partir du début du tampon, en unités de trames par canal ou de groupes d'entrelacement de trames.

*reserved2*\
Type : UINT32

Réservé.

*full*\
Type : UINT32

Lecture/Écriture : lorsque le pointeur de lecture et le pointeur d'écriture sont égaux, *full* indique si le tampon est vide ou plein (0 == vide, 1 == plein).

*reserved3*\
Type : UINT32

Réservé.

*reserved4*\
Type : UINT32

Réservé.

*address*\
Type : UINT32

Écriture : adresse du tampon, alignée sur 128 échantillons.

*numFrames*\
Type : UINT32

Écriture : *numFrames* + 1 est égal au nombre de trames par canal, ou au nombre de groupes d'entrelacement de trames dans le tampon DMA en mémoire système. Une valeur de zéro indique une trame. À partir de ces informations, le bloc DMA peut déduire la taille du tampon circulaire DMA. Ce champ est défini lorsque le contexte et le tampon sont définis.

*reserved5*\
Type : UINT32

Réservé.

*floatConvert*\
Type : UINT32

Écriture : 1 si les données doivent être converties en virgule flottante ou à partir de la virgule flottante. 0 si les données sont un entier 32 bits.

*reserved6*\
Type : UINT32

Réservé.

*numChannels*\
Type : UINT32

Écriture : *numChannels* + 1 correspond au nombre de canaux audio dans le tampon. Une valeur de zéro indique un canal.

*reserved7*\
Type : UINT32

Réservé.

*channel*\
Type : UINT32

Écriture : canal à lire/écrire.

*reserved8*\
Type : UINT32

Réservé.

## Remarques

Les membres marqués **Lecture** sont écrits par la bibliothèque ACP et doivent uniquement être lus par votre application. Les membres marqués **Écriture** sont définis par votre application et ne sont pas modifiés par la bibliothèque ACP. Les membres marqués **Lecture/Écriture** sont définis par votre application mais peuvent être modifiés par la bibliothèque ACP.

Pour plus d'informations sur les flowgraphs, consultez [Analyse des flowgraphs dans la vue d'ensemble de l'ACP](/fr/build/console-features/audio/overviews/acp-overview#ID4EHF).

## Configuration requise

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

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

## Documentation conceptuelle

* [Vue d'ensemble de l'ACP](/fr/build/console-features/audio/overviews/acp-overview)

## Voir aussi

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


## Related topics

- [ShapeDmaContext](/fr/reference/audio/shapedmacontext/shapedmacontext_members.md)
- [GetShapeDmaChannel](/fr/reference/audio/shapedmacontext/functions/getshapedmachannel.md)
- [GetShapeDmaTimestamp](/fr/reference/audio/shapedmacontext/functions/getshapedmatimestamp.md)
- [SetShapeDmaChannel](/fr/reference/audio/shapedmacontext/functions/setshapedmachannel.md)
- [GetShapeDmaAudioBuffer](/fr/reference/audio/shapedmacontext/functions/getshapedmaaudiobuffer.md)