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.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dsound.h.
  Import Library: Use dsound.lib.

See Also

IDirectSound3DListener::SetRolloffFactor