KSPROPERTY_AUDIO_VOLUMELEVEL

Article
06/15/2023

La propriété KSPROPERTY_AUDIO_VOLUMELEVEL spécifie le niveau de volume d’un canal dans un nœud de volume (KSNODETYPE_VOLUME).

Tableau récapitulatif de l’utilisation

Obtenir	Définissez	Cible	Type de descripteur de propriété	Type de valeur de propriété
Oui	Oui	Nœud via un filtre ou une épingle instance	KSNODEPROPERTY_AUDIO_CHANNEL	LONG

La valeur de la propriété est de type LONG et spécifie le niveau de volume d’un canal dans un flux donné. Les valeurs au niveau du volume utilisent l’échelle suivante :

-2147483648 est -infinity decibels (atténuation),

-2147483647 est -32767.99998474 décibels (atténuation), et

+2147483647 est +32767,99998474 décibels (gain).

Notes

La plage de décibels est représentée par des valeurs entières comprises entre -2147483648 et +2147483647, où cette échelle a une résolution de 1/65536 décibels.

Si une valeur est spécifiée au-delà de la plage du filtre, la demande de définition de cette propriété réussit toujours. Toutefois, la valeur réelle qui a été appliquée au filtre ne peut être déterminée que par un appel Get suivant à cette propriété.

Valeur de retour

Une demande de propriété KSPROPERTY_AUDIO_VOLUMELEVEL 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 descripteur de propriété pour cette propriété spécifie un numéro de canal. Si le flux qui passe par le nœud de volume contient n canaux, les canaux sont numérotés de 0 à n-1. Pour plus d’informations, consultez Exposition de nœuds multicanaux.