Interfaccia IAudioTreble (devicetopology.h)

L'interfaccia IAudioTreble consente l'accesso a un controllo a livello di treble hardware. Il client ottiene un riferimento all'interfaccia IAudioTreble di una subunit chiamando il metodo IPart::Activate con il parametro refiid impostato su REFIID IID_IAudioTreble. La chiamata a IPart::Activate ha esito positivo solo se la subunit supporta l'interfaccia IAudioTreble . Solo un oggetto subunit che rappresenta una funzione hardware per controllare il livello delle frequenze treble in ogni canale supporterà questa interfaccia.

L'interfaccia IAudioTreble fornisce controlli per canale per impostare e ottenere il livello di guadagno o attenuazione delle frequenze treble nel flusso audio. Se un controllo hardware a livello treble può attenuare solo i canali nel flusso audio, il livello massimo di treble per qualsiasi canale è 0 dB. Se un controllo a livello treble può fornire un guadagno (amplificazione), il livello massimo di treble è maggiore di 0 dB.

La maggior parte dei driver dell'adattatore audio di Windows supporta il modello di driver Windows (WDM) e usa le proprietà di streaming del kernel (KS) per rappresentare i parametri del controllo hardware nelle sottounità (denominate nodi KS). L'interfaccia IAudioTreble consente di accedere facilmente alla proprietà KSPROPERTY_AUDIO_TREBLE di una subunit con un valore GUID di sottotipo di KSNODETYPE_TONE. Per ottenere il GUID del sottotipo di una subunit, chiamare il metodo IPart::GetSubType . Per altre informazioni sulle proprietà KS e sui tipi di nodo KS, vedere la documentazione di Windows DDK.

Ereditarietà

L'interfaccia IAudioTreble eredita dall'interfaccia IPerChannelDbLevel.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	devicetopology.h

Vedi anche

Interfacce audio di base

DeviceTopology API

IPart::Activate

Interfaccia IPerChannelDbLevel