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

> SHAPE_PCM_CONTEXT

# SHAPE\_PCM\_CONTEXT

Structure de contexte PCM.

## Syntaxe

```cpp theme={null}
typedef struct SHAPE_PCM_CONTEXT {
    UINT32 bufferStart : 32;  
    UINT32 bufferLength : 21;  
    UINT32 reserved0 : 11;  
    UINT32 loopCount : 8;  
    UINT32 reserved1 : 8;  
    UINT32 full : 1;  
    UINT32 reserved2 : 15;  
    UINT32 readPointer : 21;  
    UINT32 reserved3 : 11;  
    UINT32 loopStartWritePointer : 21;  
    UINT32 reserved4 : 11;  
    UINT32 loopEnd : 21;  
    UINT32 reserved5 : 11;  
    UINT32 mode : 1;  
    UINT32 reserved6 : 15;  
    UINT32 format : 2;  
    UINT32 reserved7 : 14;  
    UINT32 reserved[1];  
} SHAPE_PCM_CONTEXT  
```

### Membres

*bufferStart*\
Type : UINT32

Écriture : mémoire tampon audio.

*bufferLength*\
Type : UINT32

Écriture : longueur de la mémoire tampon audio, en échantillons.

*reserved0*\
Type : UINT32

Réservé.

*loopCount*\
Type : UINT32

Lecture/écriture : nombre de boucles.

*reserved1*\
Type : UINT32

Réservé.

*full*\
Type : UINT32

Écriture : pour les mémoires tampons circulaires, lorsque *readPointer* est identique à *loopStartWritePointer* : 1 == mémoire tampon pleine, 0 == mémoire tampon vide.

*reserved2*\
Type : UINT32

Réservé.

*readPointer*\
Type : UINT32

Lecture/écriture : décalage en échantillons, aligné sur les trames de 128 échantillons, à partir du début de la mémoire tampon audio. Les sept (7) bits inférieurs sont ignorés.

*reserved3*\
Type : UINT32

Réservé.

*loopStartWritePointer*\
Type : UINT32

Écriture : décalage d'échantillons non aligné sur les trames, à partir du début de la mémoire tampon audio. Indique le début de la boucle pour les mémoires tampons linéaires, ou le pointeur d'écriture pour les mémoires tampons circulaires.

*reserved4*\
Type : UINT32

Réservé.

*loopEnd*\
Type : UINT32

Écriture : décalage d'échantillons non aligné sur les trames, à partir du début de la mémoire tampon audio. Indique la fin de la boucle. La taille minimale d'une boucle est de 128 échantillons.

*reserved5*\
Type : UINT32

Réservé.

*mode*\
Type : UINT32

Écriture : SHAPE\_PCM\_MODE

*reserved6*\
Type : UINT32

Réservé.

*format*\
Type : UINT32

Écriture : SHAPE\_PCM\_FORMAT

*reserved7*\
Type : UINT32

Réservé.

*reserved*\
Type : UINT32\[1]

Réservé.

## Remarques

Les champs marqués **Écriture** sont définis par votre application et ne sont pas modifiés par la bibliothèque ACP (Audio Control Processor). Les champs marqués **Lecture/écriture** sont définis par votre application, mais peuvent être modifiés par la bibliothèque ACP.

La taille d'une mémoire tampon PCM (Pulse Code Modulation) dépend du format de la mémoire tampon. Consultez les remarques de [SHAPE\_PCM\_FORMAT](/fr-CA/reference/audio/shapepcmcontext/enums/shape_pcm_format).

## Configuration requise

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

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

## Documentation conceptuelle

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

## Voir aussi

[Vue d'ensemble d'ACP](/fr-CA/build/console-features/audio/overviews/acp-overview)\
[Vue d'ensemble de SHAPE](/fr-CA/build/console-features/audio/overviews/shape-overview)\
[shapepcmcontext](/fr-CA/reference/audio/shapepcmcontext/shapepcmcontext_members)


## Related topics

- [SHAPE_PCM_CONTEXT](/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)
- [ShapePcmContext](/reference/audio/shapepcmcontext/shapepcmcontext_members.md)
- [SetShapePcmFormat](/reference/audio/shapepcmcontext/functions/setshapepcmformat.md)
- [SetShapePcmMode](/reference/audio/shapepcmcontext/functions/setshapepcmmode.md)
- [GetShapePcmFormat](/reference/audio/shapepcmcontext/functions/getshapepcmformat.md)