KSPROPERTY_AUDIO_MIX_LEVEL_TABLE
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 |
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.
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.
Configuration requise
En-tête |
Ksmedia.h (inclure Ksmedia.h) |