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 中定义:

  • 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 中定义:

  • 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 Speaker-Configuration 设置

要求

标头

Ksmedia (包含 Ksmedia)

另请参阅

KSPROPERTY_AUDIO_CHANNEL_CONFIG

KSNODETYPE_DAC

KSNODETYPE_3D_EFFECTS

KSNODEPROPERTY