> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SetShapePcmFormat

> SetShapePcmFormat

# SetShapePcmFormat

Définit le format PCM.

## Syntaxe

```cpp theme={null}
HRESULT SetShapePcmFormat(  
         SHAPE_PCM_CONTEXT* context,  
         SHAPE_PCM_FORMAT format  
)  
```

### Paramètres

*context*   \_Inout\_\
Type : [SHAPE\_PCM\_CONTEXT\*](https://docs.xbox.com/fr/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)

Pointeur vers une structure [SHAPE\_PCM\_CONTEXT](https://docs.xbox.com/fr/reference/audio/shapepcmcontext/structs/shape_pcm_context.md).

*format*   \
Type : [SHAPE\_PCM\_FORMAT](https://docs.xbox.com/fr/reference/audio/shapepcmcontext/enums/shape_pcm_format.md)

Un membre de l'énumération [SHAPE\_PCM\_FORMAT](https://docs.xbox.com/fr/reference/audio/shapepcmcontext/enums/shape_pcm_format.md).

### Valeur renvoyée

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

| Fonction | Description |
| - | - |
| PCM linéaire sans boucle | Démarrez la voix à l'aide de la constante `SHAPE_SRC_COMMAND_TYPE_START` pour le SRC (Sample Rate Convertor). Laissez la voix être lue jusqu'à la fin, ou arrêtez-la éventuellement 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](https://docs.xbox.com/fr/reference/audio/shapesrccontext/enums/shape_src_command_type.md). |
| PCM linéaire en boucle infinie | Définissez le nombre de boucles *loopCount* du contexte 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 être lue jusqu'à ce que vous souhaitiez l'arrêter, soit à la fin d'une boucle à l'aide de `SHAPE_SRC_COMMAND_TYPE_STOP_END` en laissant la voix se terminer, 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 une valeur comprise dans \[0, 254]. Démarrez la voix à l'aide de `SHAPE_SRC_COMMAND_TYPE_START` pour le SRC. Laissez la voix être lue jusqu'à la fin, ou arrêtez-la éventuellement à la fin d'une boucle à l'aide de `SHAPE_SRC_COMMAND_TYPE_STOP_END` en laissant la voix se terminer, 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 souhaitiez arrêter. Utilisez `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 l'arrêter immédiatement. |

Formats d'échantillons d'entrée :\\

![Diagramme illustrant l'affectation des bits pour chacun des quatre formats d'échantillons d'entrée PCM pris en charge.](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/pcm_format.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=58f4b6bb7fadd542a8c9a337cd729ba2)

## 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](https://docs.xbox.com/fr/build/console-features/audio/overviews/acp-overview.md)\
[Vue d'ensemble de SHAPE](https://docs.xbox.com/fr/build/console-features/audio/overviews/shape-overview.md)\
[shapepcmcontext](https://docs.xbox.com/fr/reference/audio/shapepcmcontext/shapepcmcontext_members.md)


## Related topics

- [ShapePcmContext](https://docs.xbox.com/fr/reference/audio/shapepcmcontext/shapepcmcontext_members.md)
- [SHAPE_PCM_FORMAT](https://docs.xbox.com/fr/reference/audio/shapepcmcontext/enums/shape_pcm_format.md)
- [SetShapePcmAudioBuffer](https://docs.xbox.com/fr/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer_2.md)
- [GetShapePcmFormat](https://docs.xbox.com/fr/reference/audio/shapepcmcontext/functions/getshapepcmformat.md)
- [Fonction SetShapePcmAudioBuffer](https://docs.xbox.com/fr/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer.md)