KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY
KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY 属性与 KSPROPERTY_AUDIO_CHANNEL_CONFIG 结合使用,实现硬件加速 3D 音频的 DirectSound 扬声器配置属性。 这是 DAC 节点 (KSNODETYPE_DAC) 和 3D 节点 (KSNODETYPE_3D_EFFECTS) 的可选属性。
使用情况摘要表
获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
---|---|---|---|---|
是 |
是 |
引脚/筛选器 |
LONG |
属性值(操作数据)的类型为 LONG,指定扬声器几何图形。 此值可以设置为以下常量之一,这些常量在头文件 Ksmedia.h 中定义:
KSAUDIO_STEREO_SPEAKER_GEOMETRY_HEADPHONES
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MIN
KSAUDIO_STEREO_SPEAKER_GEOMETRY_NARROW
KSAUDIO_STEREO_SPEAKER_GEOMETRY_WIDE
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MAX
上述参数的含义(但不等于值)等效于以下值,这些值由 IDirectSound::GetSpeakerConfig 方法使用(请参阅 Microsoft Windows SDK 文档),并在头文件 Dsound.h 中定义:
DSSPEAKER_HEADPHONE
DSSPEAKER_STEREO |DSSPEAKER_GEOMETRY_MIN
DSSPEAKER_STEREO |DSSPEAKER_GEOMETRY_NARROW
DSSPEAKER_STEREO |DSSPEAKER_GEOMETRY_WIDE
DSSPEAKER_STEREO |DSSPEAKER_GEOMETRY_MAX
返回值
KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY 属性请求返回 STATUS_SUCCESS,以指示它已成功完成。 否则,请求将返回适当的错误状态代码。
注解
DirectSound 将 KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY 视为 DAC 节点上的筛选器属性,并将该属性视为 3D 节点上的引脚属性。
有关详细信息,请参阅 DirectSound 扬声器配置设置。
要求
标头 |
Ksmedia.h(包括 Ksmedia.h) |