KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR
KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR 屬性會指定 3D 接聽程式的變換因數。
使用量摘要資料表
| Get | 集合 | 目標 | 屬性描述項類型 | 屬性值類型 |
|---|---|---|---|---|
是 |
是 |
Pin |
FLOAT |
) 作業資料 (屬性值為 FLOAT 類型，並指定變換因數。 變換因數的範圍可以從DS3D_MINROLLOFFFACTOR到DS3D_MAXROLLOFFFACTOR，分別定義為 0.0 和 10.0。 預設變換因數為 DS3D_DEFAULTROLLOFFFACTOR，定義為 1.0。
傳回值
KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR屬性要求會傳回STATUS_SUCCESS，表示它已順利完成。 否則，要求會傳回適當的錯誤狀態碼。
備註
變換是根據接聽程式與音效來源的距離，套用至音效的衰減量。 零的變換因數表示不論其與接聽程式的距離為何，都不會將衰減套用至音效。 大於 1 的因素會干擾距離的音效真實世界衰減。
DirectSound 會使用此屬性來實作IDirectSound3DListener：：GetRolloffFactor和IDirectSound3DListener：：SetRolloffFactor方法，如Microsoft Windows SDK檔中所述。
規格需求
標頭 |
Ksmedia.h (包含 Ksmedia.h) |