KSPROPERTY_AUDIO_CHANNEL_CONFIG

KSPROPERTY_AUDIO_CHANNEL_CONFIG 属性指定节点输出的音频流中通道的实际空间位置。

使用情况摘要表

获取 设置 目标 属性描述符类型 属性值类型

筛选器/引脚

KSNODEPROPERTY

KSAUDIO_CHANNEL_CONFIG

属性值(操作数据)是 KSAUDIO_CHANNEL_CONFIG 类型的结构。 此结构指定输出流中包含的通道以及将这些通道分配给扬声器。

返回值

KSPROPERTY_AUDIO_CHANNEL_CONFIG 属性请求返回 STATUS_SUCCESS,以指示它已成功完成。 否则,请求将返回适当的错误状态代码。

注解

当用作 DAC 节点 (KSNODETYPE_DAC) 或 3D 节点 (KSNODETYPE_3D_EFFECTS) 的属性时,KSPROPERTY_AUDIO_CHANNEL_CONFIG 属性指定 DirectSound 扬声器配置。 对于立体声扬声器配置,此属性与 KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY 属性结合使用,该属性区分耳机和多个立体声扬声器配置。 有关扬声器配置的详细信息,请参阅 DirectSound 扬声器配置设置

DirectSound 还使用 KSPROPERTY_AUDIO_CHANNEL_CONFIG 属性查询通道配置的“平移”节点。 平移节点是混音器引脚上的第二个卷节点 (KSNODETYPE_VOLUME),满足 DirectSound 节点排序要求IDirectSoundBuffer::SetPan 方法的 DirectSound 实现(如 Microsoft Windows SDK 文档中所述)使用平移节点的 KSPROPERTY_AUDIO_VOLUMELEVEL 属性来控制平移。

DirectSound 将 KSPROPERTY_AUDIO_CHANNEL_CONFIG 视为 DAC 节点上的筛选器属性,并将该属性视为音量和 3D 节点上的引脚属性。

客户端还使用此属性选择 KSNODETYPE_PROLOGIC_DECODER 节点输出的流的格式。

要求

标头

Ksmedia.h(包括 Ksmedia.h)

另请参阅

KSNODEPROPERTY

KSAUDIO_CHANNEL_CONFIG

KSNODETYPE_DAC

KSNODETYPE_3D_EFFECTS

KSNODETYPE_VOLUME

KSNODETYPE_PROLOGIC_DECODER

KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY

KSPROPERTY_AUDIO_VOLUMELEVEL