KSPROPERTY_AUDIO_CHANNEL_CONFIG

Article
06/15/2023

La propriété KSPROPERTY_AUDIO_CHANNEL_CONFIG spécifie l’emplacement spatial réel des canaux dans le flux audio généré par un nœud.

Tableau récapitulatif de l’utilisation

Obtenir	Définissez	Cible	Type de descripteur de propriété	Type de valeur de propriété
Oui	Oui	Filtrer/épingler	KSNODEPROPERTY	KSAUDIO_CHANNEL_CONFIG

La valeur de propriété (données d’opération) est une structure de type KSAUDIO_CHANNEL_CONFIG. Cette structure spécifie les canaux contenus dans le flux de sortie et l’affectation de ces canaux à des haut-parleurs.

Valeur de retour

Une demande de propriété KSPROPERTY_AUDIO_CHANNEL_CONFIG retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, la demande retourne une erreur appropriée status code.

Notes

Lorsqu’elle est utilisée comme propriété d’un nœud DAC (KSNODETYPE_DAC) ou d’un nœud 3D (KSNODETYPE_3D_EFFECTS), la propriété KSPROPERTY_AUDIO_CHANNEL_CONFIG spécifie la configuration de l’orateur DirectSound. Pour les configurations de haut-parleur stéréo, cette propriété est utilisée conjointement avec la propriété KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY , qui fait la distinction entre les écouteurs et plusieurs configurations de haut-parleur stéréo. Pour plus d’informations sur les configurations des haut-parleurs, consultez Paramètres de Speaker-Configuration DirectSound.

DirectSound utilise également la propriété KSPROPERTY_AUDIO_CHANNEL_CONFIG pour interroger un nœud « panoramique » pour sa configuration de canal. Un nœud panoramique est le deuxième nœud de volume (KSNODETYPE_VOLUME) sur une broche de mélangeur qui répond aux exigences de classement des nœuds DirectSound. L’implémentation DirectSound de la méthode IDirectSoundBuffer::SetPan (décrite dans la documentation Microsoft Windows SDK) utilise la propriété KSPROPERTY_AUDIO_VOLUMELEVEL du nœud panoramique pour contrôler le panoramique.

DirectSound traite KSPROPERTY_AUDIO_CHANNEL_CONFIG comme une propriété de filtre sur un nœud DAC et comme une propriété de broche sur les nœuds de volume et 3D.

Les clients utilisent également cette propriété pour sélectionner le format du flux qu’un nœud KSNODETYPE_PROLOGIC_DECODER génère.