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

# Fonction SetShapePcmAudioBuffer

> Fonction SetShapePcmAudioBuffer

# Fonction SetShapePcmAudioBuffer

Définit la mémoire tampon audio PCM.

Il s'agit d'une fonction surchargée qui accepte un pointeur virtuel. [SetShapePcmAudioBuffer](/fr/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer_2) accepte une adresse physique.

## Syntaxe

```cpp theme={null}
HRESULT SetShapePcmAudioBuffer(  
         SHAPE_PCM_CONTEXT* context,  
         const void* audioBuffer  
)  
```

### Paramètres

*context*   \_Inout\_\
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).

*audioBuffer*   \_In\_\
Type : void\*

Pointeur vers la mémoire tampon audio. L'exigence d'alignement dépend du type de mémoire tampon et du format.

### Valeur renvoyée

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

Le bloc SRC (Sample Rate Convertor) lit des données PCM (Pulse Code Modulation) 16 bits, 24 bits ou 32 bits à virgule fixe, ou 32 bits à virgule flottante, depuis la mémoire système et effectue une conversion de fréquence d'échantillonnage basée sur des entiers. Les données de sortie sont écrites dans des mémoires tampons de mixage. Pour les données d'entrée, le bloc SRC peut utiliser soit la sortie du décodeur matériel XMA (XBOX Media Audio), soit des données gérées par logiciel. Le bloc SRC est étroitement intégré au décodeur XMA. Cela permet au bloc SRC de déterminer si la mémoire tampon de décodage XMA contient suffisamment d'échantillons de données PCM décodées sans lire la mémoire principale.

Un traitement SRC est généralement utilisé pour l'émulation d'instruments de musique, la conversion d'échantillons d'entrée une octave plus bas ou plus haut que la source, ou des effets tels que l'effet Doppler.

Le SRC fonctionne en mode mono ou stéréo. Les données PCM sont lues depuis la mémoire et converties dans un format commun à virgule fixe sur 24 bits pour la conversion de fréquence d'échantillonnage. La sortie est écrite dans une ou deux mémoires tampons de mixage selon le mode. Les données stéréo sont stockées en mémoire sous la forme d'un flux entrelacé de données 16 bits, le canal gauche occupant les 16 bits de poids faible de chaque mot de 32 bits et le canal droit les 16 bits de poids fort. En mode stéréo, les données PCM sont lues et désentrelacées simultanément. Les données du canal gauche (échantillons de rang pair) sont traitées et envoyées vers une mémoire tampon de mixage, et les données du canal droit (échantillons de rang impair) sont écrites dans une seconde mémoire tampon de mixage.

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

- [SetShapePcmAudioBuffer](/zh-CN/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer_2.md)
- [SetShapePcmAudioBuffer function](/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer.md)
- [SetShapePcmAudioBuffer 函数](/zh-CN/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer.md)
- [Función SetShapePcmAudioBuffer](/es/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer.md)