Skip to main content

Fonction SetShapePcmAudioBuffer

Définit la mémoire tampon audio PCM. Il s’agit d’une fonction surchargée qui accepte un pointeur virtuel. SetShapePcmAudioBuffer accepte une adresse physique.

Syntaxe

Paramètres

context   _Inout_
Type : SHAPE_PCM_CONTEXT*
Pointeur vers une structure 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
Vue d’ensemble de SHAPE
shapepcmcontext
Last modified on October 6, 2026