IDirectSound3DListener::SetDistanceFactor

HRESULT SetDistanceFactor(

D3DVALUE flDistanceFactor, DWORD dwApply);

Sets the current distance factor.

·Returns DS_OK if successful, or DSERR_INVALIDPARAM otherwise.

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

For additional information about distance factors, see Distance Factor.