KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR
KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR 属性指定 3D 侦听器的衰减因子。
使用情况摘要表
| 获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
是 |
是 |
固定 |
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） |