KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY

KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY 属性与 KSPROPERTY_AUDIO_CHANNEL_CONFIG 结合使用,实现硬件加速 3D 音频的 DirectSound 扬声器配置属性。 这是 DAC 节点 (KSNODETYPE_DAC) 和 3D 节点 (KSNODETYPE_3D_EFFECTS) 的可选属性。

使用情况摘要表

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

引脚/筛选器

KSNODEPROPERTY

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)

另请参阅

KSPROPERTY_AUDIO_CHANNEL_CONFIG

KSNODETYPE_DAC

KSNODETYPE_3D_EFFECTS

KSNODEPROPERTY