IDirectSound3DListener::SetDistanceFactor

The IDirectSound3DListener::SetDistanceFactor method sets the current distance factor.

HRESULT SetDistanceFactor(

D3DVALUE flDistanceFactor,

DWORD dwApply

);

Parameters
flDistanceFactor
New distance 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 3-D coordinates for all 3-D sound buffers.

Return Values

If the method succeeds, the return value is DS_OK.

If the method fails, the return value may be DSERR_INVALIDPARAM.

Remarks

For additional information about distance factors, see Distance Factor.

See Also

IDirectSound3DListener::GetDistanceFactor