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

La structure de contexte de l'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 de la mémoire 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 de la mémoire tampon, en unités de trames par canal ou de groupes de trames entrelacées.

*reserved1*\
Type : UINT32

Réservé.

*writePointer*\
Type : UINT32

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

*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 la mémoire tampon est vide ou pleine (0 == vide, 1 == pleine).

*reserved3*\
Type : UINT32

Réservé.

*reserved4*\
Type : UINT32

Réservé.

*address*\
Type : UINT32

Écriture : adresse de la mémoire 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 de trames entrelacées dans la mémoire tampon DMA de la mémoire système. Une valeur de zéro indique une trame. À partir de ces informations, le bloc DMA peut déduire la taille de la mémoire tampon circulaire DMA. Ce champ est défini lors de la définition du contexte et de la mémoire tampon.

*reserved5*\
Type : UINT32

Réservé.

*floatConvert*\
Type : UINT32

Écriture : 1 si les données doivent être converties en valeur à virgule flottante ou à partir de celle-ci. 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 la mémoire tampon. Une valeur de zéro indique un canal.

*reserved7*\
Type : UINT32

Réservé.

*channel*\
Type : UINT32

Écriture : le canal à lire ou à écrire.

*reserved8*\
Type : UINT32

Réservé.

## Remarques

Les membres marqués **Lecture** sont écrits par la bibliothèque ACP et ne doivent être que 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 graphes de flux, consultez [Analyse des graphes de flux dans Vue d'ensemble de l'ACP](/fr-CA/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-CA/build/console-features/audio/overviews/acp-overview)

## Voir aussi

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


## Related topics

- [SHAPE_DMA_CONTEXT](/reference/audio/shapedmacontext/structs/shape_dma_context.md)
- [ShapeDmaContext](/reference/audio/shapedmacontext/shapedmacontext_members.md)