IDirectSound3DListener::GetRolloffFactor
The IDirectSound3DListener::GetRolloffFactor method retrieves the current rolloff factor.
HRESULT GetRolloffFactor(
LPD3DVALUE lpflRolloffFactor
);
Parameters
lpflRolloffFactor
Address of a variable whose type is D3DVALUE and that will contain the current rolloff factor value.
Return Values
If the method succeeds, the return value is DS_OK.
If the method fails, the return value may be DSERR_INVALIDPARAM.
Remarks
The rolloff factor has a range of DS3D_MINROLLOFFFACTOR (no rolloff) to DS3D_MAXROLLOFFFACTOR (as currently defined, 10 times the rolloff found in the real world). The default value is DS3D_DEFAULTROLLOFFFACTOR (1.0). For additional information, see Rolloff Factor.
QuickInfo
Windows NT: Use version 5.0 or later.
Windows: Use Windows 95 OSR2 or later. Available as a redistributable for Windows 95.
Windows CE: Unsupported.
Header: Declared in dsound.h.
Import Library: Use dsound.lib.
See Also