KSPROPERTY_AUDIO_MIX_LEVEL_TABLE

Article
11/14/2023

La propriété KSPROPERTY_AUDIO_MIX_LEVEL_TABLE spécifie les niveaux de mixage d’un nœud de supermixeur (KSNODETYPE_SUPERMIX). Il fournit des informations pour tous les canaux d’entrée et de sortie.

Tableau récapitulatif de l’utilisation

Get	Set	Cible	Type de descripteur de propriété	Type de valeur de propriété
Oui	Facultatif	Épingle	KSNODEPROPERTY	Tableau de structures KSAUDIO_MIXLEVEL

Le nœud est requis pour implémenter la prise en charge des requêtes KSPROPERTY_TYPE_GET. Toutefois, la prise en charge des demandes KSPROPERTY_TYPE_SET est facultative.

La valeur de propriété (données d’opération) est un tableau de structures KSAUDIO_MIXLEVEL qui spécifie les niveaux de combinaison pour tous les chemins d’entrée-sortie M*N d’un nœud de supermixeur avec des canaux d’entrée M et des canaux de sortie N. Le tableau contient des éléments M*N :

  KSAUDIO_MIXLEVEL  MixLevel[M*N];

Le tableau suivant montre le mappage des éléments de tableau aux chemins d’entrée-sortie M*N du nœud de supermixer.

Élément Array	chemin d’accès Input-Output
MixLevel[0]	Canal d’entrée 0 vers canal de sortie 0
MixLevel[1]	Canal d’entrée 0 vers le canal de sortie 1
MixLevel[N-1]	Canal d’entrée 0 vers le canal de sortie N-1
MixLevel[N]	Canal d’entrée 1 vers le canal de sortie 0
MixLevel[N+1]	Canal d’entrée 1 vers le canal de sortie 1
MixLevel[2N-1]	Canal d’entrée 1 vers le canal de sortie N-1
MixLevel[M*N-1]	Canal d’entrée M-1 vers le canal de sortie N-1

La figure suivante illustre le mappage d’éléments de tableau MixLevel aux chemins d’entrée-sortie. L’index de l’élément de tableau MixLevel contrôlant chaque chemin d’entrée-sortie est affiché entre crochets.

Diagramme illustrant le mappage des éléments du tableau MixLevel d’un nœud de supermélange aux chemins d’entrée-sortie.

Si aucun chemin ne connecte le canal d’entrée i au canal de sortie j, le filtre doit définir le membre Mute de l’élément de tableau MixLevel[i*N+j] sur TRUE.

La taille du tableau de KSAUDIO_MIXLEVEL est calculée à partir de la structure KSAUDIO_MIXCAP_TABLE récupérée à partir de KSPROPERTY_AUDIO_MIX_LEVEL_CAPS. Si les membres InputChannels et OutputChannels de la structure contiennent les valeurs m et n, la taille du tableau est

M * Â¡n * sizeof(KSAUDIO_MIXLEVEL)

Valeur de retour

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

Remarques

Le filtre réussit une KSPROPERTY_AUDIO_MIX_LEVEL_TABLE demande set-property qui spécifie une valeur de niveau mix (membre de niveau de KSAUDIO_MIXLEVEL) qui dépasse la plage du filtre, mais qui fixe (en mode silencieux) la valeur à la plage prise en charge. Dans une demande suivante d’obtention de cette propriété, toutefois, le filtre génère la valeur réelle utilisée.