Partager via


KSPROPERTY_AUDIOENGINE_VOLUMELEVEL

La propriété KSPROPERTY_AUDIOENGINE_VOLUMELEVEL spécifie le niveau de volume d’un canal dans un flux donné.

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 pin instance

KSNODEPROPERTY_AUDIO_CHANNEL

LONG (pour une requête Get) et KSAUDIOENGINE_VOLUMELEVEL (pour une demande Set).

Pour une requête Get, 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 et peuvent être limitées par les valeurs minimales et maximales fournies dans la réponse prise en charge de base pour cette propriété :

-2147483648 (0x80000000 en hexadécimal, ou LONG_MIN) est -Infini décibels (atténuation),

-2147483647 (0x80000001 en hexadécimal, ou LONG_MIN + 1) est -32767.99998474 décibels (atténuation), et

+2147483647 (0x7FFFFFFF en hexadécimal, ou LONG_MAX) 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.

Pour une requête Set, la valeur de la propriété est de type KSAUDIOENGINE_VOLUMELEVEL, et elle spécifie le niveau de volume souhaité d’un canal dans un flux donné, ainsi qu’un type de courbe et une durée de courbe à appliquer lorsque le niveau de volume est défini. 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 ultérieur à cette propriété.

Valeur de retour

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

Notes

Le descripteur de propriété pour KSPROPERTY_AUDIOENGINE_VOLUMELEVEL spécifie un numéro de canal. Si le flux qui passe par le nœud du moteur audio contient n canaux, les canaux sont numérotés de 0 à n-1. Notez également qu’une valeur de canal de 0xFFFFFFFF indique que la demande s’applique à tous les canaux. Si une demande de propriété est effectuée alors que le flux n’est pas en cours d’exécution, le niveau de volume est immédiatement défini sur le niveau demandé. Si le flux quitte l’état d’exécution alors qu’une rampe de niveau volume est en cours, le niveau de volume du flux est immédiatement défini sur le niveau cible du fondu actuel. Si une nouvelle demande de propriété est effectuée alors qu’une rampe de niveau de volume existante est en cours, la nouvelle demande de rampe doit commencer à partir du niveau de volume actuel, à savoir le niveau que le volume avait atteint à l’arrivée de la nouvelle demande.

Spécifications

Version

Windows 8

En-tête

Ksmedia.h

Voir aussi

KSAUDIOENGINE_VOLUMELEVEL

KSNODEPROPERTY_AUDIO_CHANNEL

KSPROPERTY_AUDIOENGINE

KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS