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

# GetShapeDmaBufferFull

> GetShapeDmaBufferFull

# GetShapeDmaBufferFull

Obtient l'indicateur de mémoire tampon pleine.

## Syntaxe

```cpp theme={null}
bool GetShapeDmaBufferFull(  
         const SHAPE_DMA_CONTEXT* context  
)  
```

### Paramètres

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

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

### Valeur de retour

Type : bool

L'indicateur de mémoire tampon pleine.

## Remarques

Le système d'accès direct à la mémoire (DMA) prend en charge les fonctionnalités de lecture et d'écriture avec conversion automatique de virgule flottante en entier et d'entier en virgule flottante. Le système DMA utilise des mémoires tampons circulaires contenant des échantillons désentrelacés en blocs de 128 échantillons.

Le processeur DMA permet au Scalable Hardware Audio Processing Engine (SHAPE) d'envoyer des données des mémoires tampons de mixage vers la mémoire principale du système et de récupérer des données de la mémoire principale du système dans les mémoires tampons de mixage pour un traitement ultérieur. Le DMA s'effectue par bloc, en transférant une trame audio de données à la fois. Pour faciliter les données entrelacées par bloc, une valeur de saut spécifie le nombre de blocs de trames audio en mémoire système à sauter (à partir de l'adresse de base) lors de la lecture ou de l'écriture d'échantillons. Les flux multicanaux nécessitent donc un contexte DMA par canal.

Les échantillons de données audio sont toujours lus et écrits sous forme de valeurs 32 bits, entières ou à virgule flottante, comme spécifié dans l'indicateur `floatConvert` de la structure [SHAPE\_DMA\_CONTEXT](/fr-CA/reference/audio/shapedmacontext/structs/shape_dma_context). Notez que la direction du DMA (lecture ou écriture) est spécifiée dans la commande DMA, et non dans le contexte DMA. Cela aide à réduire la quantité de bande passante de données. Le moteur DMA n'effectue aucun traitement du signal, mais il peut effectuer une conversion de virgule flottante en entier (ou d'entier en virgule flottante). Cela permet au processeur de l'application de traiter les échantillons de données en format à virgule flottante.

Pour calculer la taille d'une mémoire tampon DMA, utilisez la formule suivante :

```cpp theme={null}
fullBufferSizeInBytes = 128 * 4 * numChannels * numFrames  
```

Les pointeurs de lecture et d'écriture sont incrémentés comme suit :

```cpp theme={null}
readPointer = (readPointer + 1) % numFrames 

writePointer = (writePointer + 1) % numFrames  
```

Les adresses dans la mémoire tampon audio sont calculées comme suit :

```cpp theme={null}
readAddress = audioBuffer + (128 * 4 * ((readPointer * numChannels) + channel))   

writeAddress = audioBuffer + (128 * 4 * ((writePointer * numChannels) + channel))  
```

## Configuration requise

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

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

## Voir aussi

[Vue d'ensemble de SHAPE](/fr-CA/build/console-features/audio/overviews/shape-overview)\
[ShapeDmaContext](/fr-CA/reference/audio/shapedmacontext/shapedmacontext_members)


## Related topics

- [GetShapeDmaBufferFull](/reference/audio/shapedmacontext/functions/getshapedmabufferfull.md)
- [ShapeDmaContext](/reference/audio/shapedmacontext/shapedmacontext_members.md)