通过

KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR

  • 项目

KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR 属性指定应用于任何距离值的距离因子。

使用情况摘要表

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

是

是

固定

KSNODEPROPERTY

FLOAT

属性值（操作数据）的类型为 FLOAT，并指定距离因子。

返回值

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

注解

KSPROPSETID_DirectSound3DBuffer 和 KSPROPSETID_DirectSound3DListener 属性的距离以米乘以距离因子为单位表示。

默认情况下，距离因子为 1，因此以米为单位表示距离。 （此外，默认速度单位为每秒米数。)

客户端可以通过发送指定不同距离因子的 KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR set 属性请求来更改 KSPROPSETID_DirectSound3DBuffer和 KSPROPSETID_DirectSound3DListener 属性的距离单位。

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

要求

标头

 Ksmedia.h（包括 Ksmedia.h）

另请参阅

KSNODEPROPERTY