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

# SetShapePcmAudioBuffer

> SetShapePcmAudioBuffer

# SetShapePcmAudioBuffer

Définit le tampon audio PCM.

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

## Syntaxe

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

### Paramètres

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

*audioBuffer*   \_In\_\
Type : APU\_ADDRESS

Adresse physique du tampon audio. L'alignement dépend du type de tampon et du format.

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

Le bloc du convertisseur de fréquence d'échantillonnage (SRC) lit des données de modulation par impulsions et codage (PCM) en virgule fixe 16 bits, 24 bits ou 32 bits, ou en virgule flottante 32 bits, à partir de 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 tampons de mixage. Comme données d'entrée, le bloc SRC peut utiliser soit la sortie du décodeur matériel XBOX Media Audio (XMA), 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 le tampon de décodage XMA contient suffisamment d'échantillons de données PCM décodées sans lire la mémoire principale

Un processus SRC est généralement utilisé pour l'émulation d'instruments de musique, la conversion d'échantillons d'entrée à une octave inférieure ou supérieure à la source, ou des effets comme 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 en virgule fixe 24 bits pour la conversion de fréquence d'échantillonnage. La sortie est écrite dans un ou deux tampons de mixage selon le mode. Les données stéréo sont stockées en mémoire sous forme de 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 pairs) sont traitées et envoyées vers un tampon de mixage, et les données du canal droit (échantillons impairs) sont écrites dans un second 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-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

- [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)