structure KSAUDIO_CHANNEL_CONFIG (ksmedia.h)

La structure KSAUDIO_CHANNEL_CONFIG spécifie la configuration des canaux dans le format de données d’un flux audio.

Syntaxe

typedef struct {
  LONG ActiveSpeakerPositions;
} KSAUDIO_CHANNEL_CONFIG, *PKSAUDIO_CHANNEL_CONFIG;

Membres

ActiveSpeakerPositions

Spécifie à la fois le nombre de canaux et l’affectation de ces canaux aux positions d’orateur. Ce membre est un masque de bits dans lequel chaque bit dans le masque correspond à une position particulière de l’orateur. Si un bit de masque est défini, le flux audio contient un canal qui est affecté à la position du haut-parleur que le bit de masque représente. Le nombre de canaux dans le flux est obtenu en comptant le nombre de nombres 1 qui apparaissent dans le masque de bits. Pour plus d'informations, consultez la section Notes qui suit.

Remarques

Cette structure permet de définir ou d’obtenir la valeur de données de la propriété KSPROPERTY_AUDIO_CHANNEL_CONFIG .

Le tableau suivant montre les bits d’indicateur définis pour le membre ActiveSpeakerPositions .

Position de l’orateur	Bit d’indicateur
SPEAKER_FRONT_LEFT	0x1
SPEAKER_FRONT_RIGHT	0x2
SPEAKER_FRONT_CENTER	0x4
SPEAKER_LOW_FREQUENCY	0x8
SPEAKER_BACK_LEFT	0x10
SPEAKER_BACK_RIGHT	0x20
SPEAKER_FRONT_LEFT_OF_CENTER	0x40
SPEAKER_FRONT_RIGHT_OF_CENTER	0x80
SPEAKER_BACK_CENTER	0x100
SPEAKER_SIDE_LEFT	0x200
SPEAKER_SIDE_RIGHT	0x400
SPEAKER_TOP_CENTER	0x800
SPEAKER_TOP_FRONT_LEFT	0x1000
SPEAKER_TOP_FRONT_CENTER	0x2000
SPEAKER_TOP_FRONT_RIGHT	0x4000
SPEAKER_TOP_BACK_LEFT	0x8000
SPEAKER_TOP_BACK_CENTER	0x10000
SPEAKER_TOP_BACK_RIGHT	0x20000

Chaque format de données audio contient des canaux pour une ou plusieurs des positions précédentes de l’orateur. Le nombre de canaux est simplement égal au nombre de bits d’indicateur différents de zéro dans le membre ActiveSpeakerPositions .

Les positions relatives des canaux dans chaque bloc de données audio suivent toujours le même ordre relatif que les bits d’indicateur dans le tableau précédent. Par exemple, si ActiveSpeakerPositions contient la valeur 0x00000033, le format définit quatre canaux audio qui sont affectés à la lecture aux haut-parleurs front-left, front-right, back-left et back-right, respectivement. Les données de canal doivent être entrelacées dans cet ordre dans chaque bloc. (Il s’agit de la configuration KSAUDIO_SPEAKER_QUAD qui apparaît dans la deuxième des deux tables suivantes.)

Le tableau suivant présente les configurations d’orateur définies pour le DVD.

Configuration	Position de l’orateur
KSAUDIO_SPEAKER_GROUND_FRONT_LEFT	SPEAKER_FRONT_LEFT
KSAUDIO_SPEAKER_GROUND_FRONT_CENTER	SPEAKER_FRONT_CENTER
KSAUDIO_SPEAKER_GROUND_FRONT_RIGHT	SPEAKER_FRONT_RIGHT
KSAUDIO_SPEAKER_GROUND_REAR_LEFT	SPEAKER_BACK_LEFT
KSAUDIO_SPEAKER_GROUND_REAR_RIGHT	SPEAKER_BACK_RIGHT
KSAUDIO_SPEAKER_TOP_MIDDLE	SPEAKER_TOP_CENTER
KSAUDIO_SPEAKER_SUPER_WOOFER	SPEAKER_LOW_FREQUENCY

Le tableau suivant montre les configurations d’orateur définies pour DirectSound.

Configuration	Positions de l’orateur
KSAUDIO_SPEAKER_DIRECTOUT	0 (pas de haut-parleurs)
KSAUDIO_SPEAKER_MONO	SPEAKER_FRONT_CENTER
KSAUDIO_SPEAKER_STEREO	SPEAKER_FRONT_LEFT
	SPEAKER_FRONT_RIGHT
KSAUDIO_SPEAKER_QUAD	SPEAKER_FRONT_LEFT
	SPEAKER_FRONT_RIGHT
	SPEAKER_BACK_LEFT
	SPEAKER_BACK_RIGHT
KSAUDIO_SPEAKER_SURROUND	SPEAKER_FRONT_LEFT
	SPEAKER_FRONT_RIGHT
	SPEAKER_FRONT_CENTER
	SPEAKER_BACK_CENTER
KSAUDIO_SPEAKER_5POINT1	SPEAKER_FRONT_LEFT
	SPEAKER_FRONT_RIGHT
	SPEAKER_FRONT_CENTER
	SPEAKER_LOW_FREQUENCY
	SPEAKER_BACK_LEFT
	SPEAKER_BACK_RIGHT
KSAUDIO_SPEAKER_5POINT1_SURROUND	SPEAKER_FRONT_LEFT
	SPEAKER_FRONT_RIGHT
	SPEAKER_FRONT_CENTER
	SPEAKER_LOW_FREQUENCY
	SPEAKER_SIDE_LEFT
	SPEAKER_SIDE_RIGHT
KSAUDIO_SPEAKER_7POINT1	SPEAKER_FRONT_LEFT
	SPEAKER_FRONT_RIGHT
	SPEAKER_FRONT_CENTER
	SPEAKER_LOW_FREQUENCY
	SPEAKER_BACK_LEFT
	SPEAKER_BACK_RIGHT
	SPEAKER_FRONT_LEFT_OF_CENTER
	SPEAKER_FRONT_RIGHT_OF_CENTER
KSAUDIO_SPEAKER_7POINT1_SURROUND	SPEAKER_FRONT_LEFT
	SPEAKER_FRONT_RIGHT
	SPEAKER_FRONT_CENTER
	SPEAKER_LOW_FREQUENCY
	SPEAKER_BACK_LEFT
	SPEAKER_BACK_RIGHT
	SPEAKER_SIDE_LEFT
	SPEAKER_SIDE_RIGHT

La configuration de l’orateur KSAUDIO_SPEAKER_7POINT1 est obsolète et n’est plus prise en charge.

Dans le tableau précédent, la constante KSAUDIO_SPEAKER_DIRECTOUT a la valeur zéro, ce qui signifie qu’aucune position d’orateur n’est affectée aux canaux dans le flux multicanal. Par exemple, le canal zéro peut représenter la percussion, le canal 1 peut représenter la trompette, le canal 2 peut représenter la voix, et ainsi de suite. Dans cette configuration, les canaux du flux d’entrée sont directement générés vers le matériel sans modification et sans être interprétés comme des positions d’orateur. Pour plus d’informations, consultez Configuration de l’orateur DSSPEAKER_DIRECTOUT.

La configuration de l’orateur pour un format surround 5.1 canaux est définie par la constante KSAUDIO_SPEAKER_5POINT1_SURROUND dans le tableau précédent. La disposition géométrique des haut-parleurs est illustrée dans la figure suivante, qui montre les positions des haut-parleurs avant-gauche, avant-droit, avant-centre, côté gauche et côté droit. La figure omet le haut-parleur à basse fréquence, car il n’est pas direct.

Pour cet exemple, la liste suivante montre l’ordre des six canaux dans chaque bloc de données audio :

1. SPEAKER_FRONT_LEFT

2. SPEAKER_FRONT_RIGHT

3. SPEAKER_FRONT_CENTER

4. SPEAKER_LOW_FREQUENCY

5. SPEAKER_SIDE_LEFT

6. SPEAKER_SIDE_RIGHT

Pour un format PCM avec une taille d’exemple 16 bits, chaque bloc de données audio occupe 12 octets, qui sont triés comme indiqué dans le tableau suivant.

Byte	Données audio
0	Avant gauche (8 LSB)
1	Front gauche (8 MMB)
2	Front droit (8 LSB)
3	Front droit (8 MMB)
4	Front Center (8 LSB)
5	Front Center (8 MMB)
6	Faible fréquence (8 LSB)
7	Faible fréquence (8 MMB)
8	Côté gauche (8 LSB)
9	Côté gauche (8 MMB)
10	Côté droit (8 LSB)
11	Côté droit (8 MMB)

Configuration requise

Condition requise	Valeur
En-tête	ksmedia.h (inclure Ksmedia.h)

Voir aussi

KSPROPERTY_AUDIO_CHANNEL_CONFIG

WAVEFORMATEXTENSIBLE