iAudioChannelConfig 接口 (devicetopology.h)

IAudioChannelConfig 接口提供对硬件通道配置控件的访问。 客户端通过调用 IPart::Activate 方法获取对子单元的 IAudioChannelConfig 接口的引用,并将参数 refiid 设置为 REFIID IID_IAudioChannelConfig。 仅当子单元支持 IAudioChannelConfig 接口时,对 IPart::Activate 的调用才会成功。 只有表示硬件通道配置控件的子单元对象才支持此接口。

IAudioChannelConfig 接口的客户端通过将通道配置掩码写入控件来对硬件通道配置控件进行程序化。 掩码指定向扬声器分配音频通道。 有关通道配置掩码的详细信息,请参阅 KSPROPERTY_AUDIO_CHANNEL_CONFIG

大多数 Windows 音频适配器驱动程序支持 Windows 驱动程序模型 (WDM) ,并使用内核流式处理 (KS) 属性来表示子单元中的硬件控制参数, (称为 KS 节点) 。 使用 IAudioChannelConfig 接口,可以方便地访问子单元的 KSPROPERTY_AUDIO_CHANNEL_CONFIG 属性,该子类型 GUID 值为 KSNODETYPE_3D_EFFECTS、KSNODETYPE_DAC、KSNODETYPE_VOLUME 或 KSNODETYPE_PROLOGIC_DECODER。 若要获取子单元的子类型 GUID,请调用 IPart::GetSubType 方法。 有关 KS 属性和 KS 节点类型的详细信息,请参阅 Windows DDK 文档。

继承

IAudioChannelConfig 接口继承自 IUnknown 接口。 IAudioChannelConfig 还具有以下类型的成员:

方法

IAudioChannelConfig 接口包含以下方法。

 
IAudioChannelConfig::GetChannelConfig

GetChannelConfig 方法从通道配置控件获取当前通道配置掩码。
IAudioChannelConfig::SetChannelConfig

SetChannelConfig 方法在通道配置控件中设置通道配置掩码。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 devicetopology.h

另请参阅

核心音频接口

DeviceTopology API

IPart::Activate