PKEY_AudioEndpoint_FullRangeSpeakers

  • 项目

PKEY_AudioEndpoint_FullRangeSpeakers 属性指定连接到音频终结点设备的全范围扬声器的通道配置掩码。 掩码指示全范围扬声器的物理配置，并指定向这些扬声器分配通道。

PROPVARIANT 结构的 vt 成员设置为 VT_UI4。

PROPVARIANT 结构的 uintVal 成员包含强制转换为 UINT 类型的通道配置掩码。

全范围扬声器能够播放从低音到高音的全范围声音。 通常，较大的扬声器是全范围，但较小的扬声器明显降低播放低音声音的能力。 在 Windows Vista 中，音频引擎使用此属性来管理音频终结点设备播放的音频输出流中的低音级别。

此属性的通道配置掩码的格式与 PKEY_AudioEndpoint_PhysicalSpeakers 属性的通道配置掩码的格式相同。 有关通道配置掩码的详细信息，请参阅 KSPROPERTY_AUDIO_CHANNEL_CONFIG。

系统从用户获取 PKEY_AudioEndpoint_FullRangeSpeakers 属性的通道配置掩码。 用户通过 Windows 多媒体控制面板输入此信息，Mmsys.cpl。 有关Mmsys.cpl的详细信息，请参阅 Windows DDK 文档。

音频终结点设备的 PKEY_AudioEndpoint_FullRangeSpeakers 属性的通道配置掩码是同一设备的 PKEY_AudioEndpoint_PhysicalSpeakers 属性的通道配置掩码的子集。

例如，如果音频终结点设备驱动一组 5.1 环绕声扬声器，则 PKEY_AudioEndpoint_PhysicalSpeakers 属性的声道配置掩码KSAUDIO_SPEAKER_5POINT1。 此掩码指示存在左前、右前、前中心、侧左和侧右扬声器，以及低音炮。 如果左前扬声器和右前扬声器足够大，足以产生低音声音，但较小的前中心和侧边扬声器则不是，则PKEY_AudioEndpoint_FullRangeSpeakers属性的通道配置掩码KSAUDIO_SPEAKER_STEREO，这仅指示左前扬声器和右前扬声器。 通道配置掩码KSAUDIO_SPEAKER_5POINT1和KSAUDIO_SPEAKER_STEREO在头文件 Ksmedia.h 中定义。

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2008 [仅限桌面应用]
Header
Mmdeviceapi.h

另请参阅

音频终结点属性

核心音频属性

PKEY_AudioEndpoint_PhysicalSpeakers 属性