KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR

KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR 属性指定 3D 侦听器的衰减因子。

使用情况摘要表

获取	设置	目标	属性描述符类型	属性值类型
是	是	固定	KSNODEPROPERTY	FLOAT

属性值（操作数据）的类型为 FLOAT，并指定衰减因子。 衰减因子的范围可以是从 DS3D_MINROLLOFFFACTOR 到 DS3D_MAXROLLOFFFACTOR，分别定义为 0.0 和 10.0。 默认衰减因子为 DS3D_DEFAULTROLLOFFFACTOR，定义为 1.0。

返回值

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

注解

衰减是应用于声音的衰减量，具体取决于侦听器与声音源的距离。 降幅系数为零意味着，无论其距离与侦听器的距离如何，都不会对声音应用衰减。 大于 1 的因子会放大真实世界中声音随距离的衰减。

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

要求

标头	Ksmedia.h（包括 Ksmedia.h）

另请参阅

KSNODEPROPERTY