Interfaccia IAudioChannelConfig (devicetopology.h)

L'interfaccia IAudioChannelConfig consente di accedere a un controllo di configurazione del canale hardware. Il client ottiene un riferimento all'interfaccia IAudioChannelConfig di una subunit chiamando il metodo IPart::Activate con il parametro refiid impostato su REFIID IID_IAudioChannelConfig. La chiamata a IPart::Activate ha esito positivo solo se la subunit supporta l'interfaccia IAudioChannelConfig . Solo un oggetto subunit che rappresenta un controllo di configurazione del canale hardware supporterà questa interfaccia.

Un client dell'interfaccia IAudioChannelConfig programma un controllo di configurazione del canale hardware scrivendo una maschera di configurazione del canale nel controllo. La maschera specifica l'assegnazione dei canali audio agli altoparlanti. Per altre informazioni sulle maschere di configurazione del canale, vedere KSPROPERTY_AUDIO_CHANNEL_CONFIG.

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 IAudioChannelConfig consente di accedere facilmente alla proprietà KSPROPERTY_AUDIO_CHANNEL_CONFIG di una subunit con un valore GUID di sottotipo di KSNODETYPE_3D_EFFECTS, KSNODETYPE_DAC, KSNODETYPE_VOLUME o KSNODETYPE_PROLOGIC_DECODER. 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 IAudioChannelConfig eredita dall'interfaccia IUnknown . IAudioChannelConfig include anche questi tipi di membri:

Metodi

L'interfaccia IAudioChannelConfig include questi metodi.

 
IAudioChannelConfig::GetChannelConfig

Il metodo GetChannelConfig ottiene la maschera di configurazione del canale corrente da un controllo di configurazione del canale.
IAudioChannelConfig::SetChannelConfig

Il metodo SetChannelConfig imposta la maschera di configurazione del canale in un controllo di configurazione del canale.

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 di base

DeviceTopology API

IPart::Activate