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

# GetShapePcmReadPointer

> GetShapePcmReadPointer

# GetShapePcmReadPointer

Obtient le pointeur de lecture.

## Syntaxe

```cpp theme={null}
UINT32 GetShapePcmReadPointer(  
         const SHAPE_PCM_CONTEXT* context  
)  
```

### Paramètres

*context*   \_In\_\
Type : [SHAPE\_PCM\_CONTEXT\*](/fr/reference/audio/shapepcmcontext/structs/shape_pcm_context)

Pointeur vers une structure [SHAPE\_PCM\_CONTEXT](/fr/reference/audio/shapepcmcontext/structs/shape_pcm_context).

### Valeur renvoyée

Type : UINT32

Spécifie le pointeur de lecture en échantillons. Ce pointeur traite deux échantillons stéréo 16 bits comme un seul échantillon 32 bits.

## Remarques

Pour éviter le blocage des commandes DMA (Direct Memory Access), assurez-vous que votre mémoire tampon audio est suffisamment grande et que les données sont diffusées à intervalles réguliers en fonction de la taille de la mémoire tampon. Par exemple, si vous diffusez quatre trames matérielles à la fois, assurez-vous qu'un multiple de ces trames (au moins huit, avec une double mise en mémoire tampon) se trouve dans la mémoire tampon afin que le matériel puisse écrire en avance sur le pointeur de lecture du titre. Vous pouvez aussi imposer le vidage de la mémoire tampon avant de soumettre le flowgraph suivant (consommer, mettre à jour le pointeur de lecture DMA, puis soumettre le flowgraph).

Démarrez la voix à l'aide de la constante `SHAPE_SRC_COMMAND_TYPE_START` pour le SRC. Continuez à diffuser des données en mettant à jour le pointeur d'écriture du contexte PCM jusqu'à ce que vous souhaitiez arrêter. Utilisez la constante `SHAPE_SRC_COMMAND_TYPE_STOP_END` pour laisser le SRC lire jusqu'au pointeur d'écriture PCM actuel `loopStartWritePointer`, ou `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE` pour arrêter immédiatement. Pour plus d'informations, consultez l'énumération [SHAPE\_SRC\_COMMAND\_TYPE](/fr/reference/audio/shapesrccontext/enums/shape_src_command_type).

## Configuration requise

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

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

## Voir aussi

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


## Related topics

- [GetShapePcmReadPointer](/reference/audio/shapepcmcontext/functions/getshapepcmreadpointer.md)
- [ShapePcmContext](/reference/audio/shapepcmcontext/shapepcmcontext_members.md)