KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR
KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR 屬性會指定應該套用至任何距離值的距離因數。
使用量摘要表格
Get | 集合 | 目標 | 屬性描述元類型 | 屬性值類型 |
---|---|---|---|---|
是 |
是 |
Pin |
FLOAT |
) 作業資料 (屬性值的類型為 FLOAT,並指定距離因數。
傳回值
KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR屬性要求會傳回STATUS_SUCCESS,表示它已順利完成。 否則,要求會傳回適當的錯誤狀態碼。
備註
KSPROPSETID_DirectSound3DBuffer和KSPROPSETID_DirectSound3DListener屬性的距離會以距離因數的公尺單位表示。
根據預設,距離因數為 1,因此以公尺表示距離。 (此外,預設速度單位為每秒公尺。)
用戶端可以傳送指定不同距離因數的KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR set-property 要求,藉此變更 KSPROPSETID_DirectSound3DBuffer 和 KSPROPSETID_DirectSound3DListener 屬性的距離單位。
DirectSound 會使用這個屬性來實作IDirectSound3DListener::GetDistanceFactor和IDirectSound3DListener::SetDistanceFactor方法,如Microsoft Windows SDK檔中所述。
規格需求
標頭 |
Ksmedia.h (包含 Ksmedia.h) |