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

# GetShapePcmLoopCount

> GetShapePcmLoopCount

# GetShapePcmLoopCount

Obtient le nombre de boucles.

## Syntaxe

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

### Paramètres

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

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

### Valeur de retour

Type : UINT32

Spécifie le nombre de boucles.

## Remarques

| Fonction | Description |
| - | - |
| PCM linéaire sans boucle | Démarrez la voix à l'aide de la constante `SHAPE_SRC_COMMAND_TYPE_START` pour le convertisseur de fréquence d'échantillonnage (SRC). Laissez la voix jouer jusqu'à la fin ou, si vous le souhaitez, arrêtez-la avant la fin à l'aide de la constante `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE`. Pour plus d'informations, consultez l'énumération [SHAPE\_SRC\_COMMAND\_TYPE](/fr-CA/reference/audio/shapesrccontext/enums/shape_src_command_type). |
| PCM linéaire en boucle infinie | Définissez le nombre de boucles *loopCount* du contexte de modulation par impulsions et codage (PCM) sur la constante `SHAPE_PCM_INFINITE_LOOP_COUNT`. Démarrez la voix à l'aide de `SHAPE_SRC_COMMAND_TYPE_START` pour le SRC. Laissez la voix jouer jusqu'à ce que vous vouliez l'arrêter, soit à la fin d'une boucle à l'aide de `SHAPE_SRC_COMMAND_TYPE_STOP_END` en laissant la voix jouer jusqu'au bout, soit immédiatement à l'aide de `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE`. |
| PCM linéaire en boucle finie | Définissez le nombre de boucles *loopCount* du contexte PCM sur \[0, 254]. Démarrez la voix à l'aide de `SHAPE_SRC_COMMAND_TYPE_START` pour le SRC. Laissez la voix jouer jusqu'à la fin ou, si vous le souhaitez, arrêtez-la à la fin d'une boucle à l'aide de `SHAPE_SRC_COMMAND_TYPE_STOP_END` en laissant la voix jouer jusqu'au bout, ou arrêtez-la immédiatement à l'aide de `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE`. |
| PCM circulaire | Démarrez la voix à l'aide de `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 vouliez arrêter. Utilisez `SHAPE_SRC_COMMAND_TYPE_STOP_END` pour laisser le SRC jouer jusqu'au pointeur d'écriture PCM actuel `loopStartWritePointer`, ou `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE` pour l'arrêter immédiatement. |

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

- [GetShapePcmLoopCount](/reference/audio/shapepcmcontext/functions/getshapepcmloopcount.md)
- [ShapePcmContext](/reference/audio/shapepcmcontext/shapepcmcontext_members.md)