Interface IAudioTreble (devicetopology.h)

L’interface IAudioTreble permet d’accéder à un contrôle de niveau triple matériel. Le client obtient une référence à l’interface IAudioTreble d’une sous-unité en appelant la méthode IPart::Activate avec refiid de paramètre défini sur REFIID IID_IAudioTreble. L’appel à IPart::Activate réussit uniquement si la sous-unité prend en charge l’interface IAudioTreble . Seul un objet de sous-unité qui représente une fonction matérielle pour contrôler le niveau des fréquences d’aigus dans chaque canal prend en charge cette interface.

L’interface IAudioTreble fournit des contrôles par canal pour définir et obtenir le niveau de gain ou d’atténuation des fréquences d’aigus dans le flux audio. Si un contrôle matériel de niveau triple ne peut atténuer que les canaux dans le flux audio, le niveau d’aigu maximal pour n’importe quel canal est de 0 dB. Si un contrôle de niveau triple peut fournir un gain (amplification), le niveau maximal d’aigus 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 KS (kernel-streaming) pour représenter les paramètres de contrôle matériel dans les sous-unités (appelées nœuds KS). L’interface IAudioTreble fournit un accès pratique à la propriété KSPROPERTY_AUDIO_TREBLE d’une sous-unité dont la valeur GUID de sous-type est KSNODETYPE_TONE. 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 IAudioTreble hérite de l’interface IPerChannelDbLevel.

Spécifications

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

Voir aussi

Interfaces audio principales

DeviceTopology API

IPart::Activate

IPerChannelDbLevel, interface