KSPROPERTY_AUDIO_EQ_LEVEL
La propriété KSPROPERTY_AUDIO_EQ_LEVEL spécifie les niveaux d’égalisation d’une table d’égalisation qui contient des entrées pour n bandes de fréquences. Il s’agit d’une propriété 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 |
Oui |
Filtrer |
Tableau LONG |
La valeur de propriété (données d’opération) est un tableau d’éléments LONG :
LONG Level[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 spécifie le niveau de l’une des bandes de la table d’égalisation. L’affectation de bandes à des éléments de tableau est illustrée dans le tableau suivant.
Array Element Description Level[0]
Niveau pour la bande 0.
Level[1]
Niveau pour la bande 1.
...
Level[N-1]
Niveau pour la bande N-1.
Les valeurs de niveau utilisent l’échelle suivante :
-2147483648 est -Infini décibels (atténuation),
-2147483647 est -32767.99998474 décibels (atténuation), et
+2147483647 est +32767,99998474 décibels (gain).
Plage de décibels représentée par les valeurs entières -2147483648 à +2147483647, où
Cette échelle a une résolution de 1/65536 décibel.
Valeur de retour
Une demande de propriété KSPROPERTY_AUDIO_EQ_LEVEL 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 filtre réussit une KSPROPERTY_AUDIO_EQ_LEVEL demande set-property qui spécifie une valeur qui dépasse la plage du filtre, mais qui limite la valeur à la plage prise en charge. Toutefois, dans une demande ultérieure d’obtention de cette propriété, elle génère la valeur réelle utilisée.
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 fréquences centrale des bandes d’égalisation sont spécifiées par la propriété KSPROPERTY_AUDIO_EQ_BANDS .
Spécifications
En-tête |
Ksmedia.h (inclure Ksmedia.h) |