Skip to main content

SetShapePcmAudioBuffer

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

Syntaxe

Paramètres

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