Interface IAudioVolumeLevel (devicetopology.h)
L’interface IAudioVolumeLevel permet d’accéder à un contrôle de volume matériel. Le client obtient une référence à l’interface IAudioVolumeLevel d’une sous-unité en appelant la méthode IPart ::Activate avec refiid de paramètre défini sur REFIID IID_IAudioVolumeLevel. L’appel à IPart ::Activate réussit uniquement si la sous-unité prend en charge l’interface IAudioVolumeLevel . Seul un objet de sous-unité qui représente un contrôle au niveau du volume matériel prend en charge cette interface.
L’interface IAudioVolumeLevel fournit des contrôles par canal pour définir et obtenir les niveaux de gain ou d’atténuation dans le flux audio. Si un contrôle matériel au niveau du volume ne peut atténuer que les canaux dans le flux audio, le niveau de volume maximal pour n’importe quel canal est de 0 dB. Si un contrôle au niveau du volume peut fournir un gain (amplification), le niveau de volume maximal est supérieur à 0 dB.
La plupart des pilotes d’adaptateur audio Windows prennent en charge le modèle de pilote Windows (WDM) et utilisent les propriétés de diffusion en continu du noyau (KS) pour représenter les paramètres de contrôle matériel dans les sous-unités (appelées nœuds KS). L’interface IAudioVolumeLevel fournit un accès pratique à la propriété KSPROPERTY_AUDIO_VOLUMELEVEL d’une sous-unité qui a une valeur GUID de sous-type KSNODETYPE_VOLUME. Pour obtenir le GUID de sous-type d’une sous-unité, appelez la méthode IPart ::GetSubType . Pour plus d’informations sur les propriétés KS et les types de nœuds KS, consultez la documentation windows DDK.
Héritage
L’interface IAudioVolumeLevel hérite de l’interface IPerChannelDbLevel.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | devicetopology.h |