IDirectSound3DListener::SetRolloffFactor

HRESULT SetRolloffFactor(

D3DVALUE flRolloffFactor, DWORD dwApply);

Sets the rolloff factor.

·Returns DS_OK if successful, or DSERR_INVALIDPARAM otherwise.

flRolloffFactor

New rolloff factor.

dwApply

Value indicating when the setting should be applied. This value must be one of the following:

DS3D_DEFERRED Settings are not applied until the application calls the IDirectSound3DListener::CommitDeferredSettings method. This allows the application to change several settings and generate a single recalculation.

DS3D_IMMEDIATE Settings are applied immediately, causing the system to recalculate the 3D coordinates for all 3D sound buffers.

The default value is DS3D_DEFAULTROLLOFFFACTOR (1.0). For additional information about the rolloff factor, see Rolloff Factor.