通过

KSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR

  • 项目

KSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR 属性指定 3D 侦听器的 Doppler 因子。

使用情况摘要表

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

是

是

固定

KSNODEPROPERTY

FLOAT

属性值（操作数据）的类型为 FLOAT，并指定 Doppler 因子。 Doppler 因子的范围可以从 DS3D_MINDOPPLERFACTOR 到 DS3D_MAXDOPPLERFACTOR，分别定义为 0.0 和 10.0。 默认因子为 DS3D_DEFAULTDOPPLERFACTOR，定义为 1.0。

返回值

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

注解

此属性指定应用于 3D 侦听器和 3D 声音缓冲区的 Doppler 因子。

Doppler 因子为零表示，无论侦听器或声音缓冲区的速度如何，都无法对声音应用 Doppler 移位。 大于 1 的因子会夸大现实世界中发生的 Doppler 移位。

DirectSound 使用此属性实现 Microsoft Windows SDK 文档中介绍的 IDirectSound3DListener::GetDopplerFactor 和 IDirectSound3DListener::SetDopplerFactor 方法。

要求

标头

 Ksmedia.h（包括 Ksmedia.h）

另请参阅

KSNODEPROPERTY