KSPROPERTY_AUDIO_EQ_BANDS

Article
06/15/2023

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.