Partager via


KSPROPERTY_AUDIO_EQ_BANDS

La propriété KSPROPERTY_AUDIO_EQ_BANDS spécifie l’ensemble des bandes de fréquences d’une table d’égalisation. Il s’agit d’une propriété get-only d’un canal dans un nœud EQ (KSNODETYPE_EQUALIZER).

Tableau récapitulatif de l’utilisation

Obtenir Définissez Cible Type de descripteur de propriété Type de valeur de propriété

Oui

Non

Filtrer

KSNODEPROPERTY_AUDIO_CHANNEL

Tableau ULONG

La valeur de propriété (données d’opération) est un tableau d’éléments ULONG :

  ULONG  CenterFreqVal[N];

Si la table d’égalisation du canal contient des entrées pour N bandes de fréquences, le tableau contient N éléments et chaque élément de tableau spécifie la fréquence centrale de la bande correspondante. Le pilote miniport écrit dans chaque élément une valeur de fréquence entière exprimée en hertz (Hz). L’affectation des bandes d’égalisation aux éléments de tableau est indiquée dans le tableau suivant.

Array Element Description CenterFreqVal[0]

Fréquence centrale (en Hz) pour la bande d’égalisation 0.

CenterFreqVal[1]

Fréquence centrale (en Hz) pour la bande d’égalisation 1.

...

CenterFreqVal[N-1]

Fréquence centrale (en Hz) pour la bande d’égalisation N-1.

Valeur de retour

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

Notes

Le nombre de bandes de péréquation peut être déterminé en soumettant d’abord une demande de KSPROPERTY_AUDIO_NUM_EQ_BANDS .

Les niveaux d’égalisation des bandes de fréquence sont spécifiés par la propriété KSPROPERTY_AUDIO_EQ_LEVEL .

Spécifications

En-tête

Ksmedia.h (inclure Ksmedia.h)

Voir aussi

KSNODEPROPERTY_AUDIO_CHANNEL

KSNODETYPE_EQUALIZER

KSPROPERTY_AUDIO_NUM_EQ_BANDS

KSPROPERTY_AUDIO_EQ_LEVEL