Interfaccia IAudioVolumeLevel (devicetopology.h)

L'interfaccia IAudioVolumeLevel fornisce l'accesso a un controllo del volume hardware. Il client ottiene un riferimento all'interfaccia IAudioVolumeLevel di una subunit chiamando il metodo IPart::Activate con il parametro refiid impostato su REFIID IID_IAudioVolumeLevel. La chiamata a IPart::Activate riesce solo se la subunit supporta l'interfaccia IAudioVolumeLevel . Solo un oggetto subunit che rappresenta un controllo a livello di volume hardware supporterà questa interfaccia.

L'interfaccia IAudioVolumeLevel fornisce controlli per canale per impostazione e ottenere i livelli di aumento o attenuazione nel flusso audio. Se un controllo hardware a livello di volume può attenuare solo i canali nel flusso audio, il livello massimo di volume per qualsiasi canale è 0 dB. Se un controllo a livello di volume può fornire un guadagno (amplificazione), il livello massimo di volume è 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 di controllo hardware nelle sottounite (denominati nodi KS). L'interfaccia IAudioVolumeLevel offre un accesso pratico alla proprietà KSPROPERTY_AUDIO_VOLUMELEVEL di una subunit con valore GUID di sottotipo di KSNODETYPE_VOLUME. Per ottenere il GUID sottotipo di una subunit, chiamare il metodo IPart::GetSubType . Per altre informazioni sulle proprietà KS e sui tipi di nodi KS, vedere la documentazione di Windows DDK.

Ereditarietà

L'interfaccia IAudioVolumeLevel eredita dall'interfaccia IPerChannelDbLevel.

Requisiti

Requisito Valore
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 principali

DeviceTopology API

IPart::Activate

Interfaccia IPerChannelDbLevel