IDirectSound3DListener8::SetRolloffFactor
SetRolloffFactor メソッドは、距離に応じた減衰率を算出するロールオフ係数を設定します。
HRESULT
SetRolloffFactor(
D3DVALUE flRolloffFactor,
DWORD dwApply
);
パラメータ
- flRolloffFactor
ロールオフ係数です。D3DVALUE は、float として定義されています。 - dwApply
設定を適用するタイミングを指定する値です。次の値のいずれかでなければなりません。
戻り値
成功した場合は、DS_OK を返します。失敗した場合は、DSERR_INVALIDPARAM を返します。
解説
ロールオフ係数の範囲は、DS3D_MINROLLOFFFACTOR (ロールオフなし) から DS3D_MAXROLLOFFFACTOR (実世界の 10 倍のロールオフ) までです。デフォルト値は DS3D_DEFAULTROLLOFFFACTOR (1.0) です。詳細については、「ロールオフ係数」を参照してください。
要件
ヘッダー: DSound.h 宣言
ライブラリ: Dsound3d.dll 内容