IDirectSound3DListener::SetDopplerFactor

HRESULT SetDopplerFactor(

D3DVALUE flDopplerFactor, DWORD dwApply);

Sets the current Doppler effect factor.

·Returns DS_OK if successful, or DSERR_INVALIDPARAM otherwise.

flDopplerFactor

New Doppler factor value.

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.

This Doppler factor has a range of 0 (no Doppler effects) to 10.0 (10 times the Doppler effects found in the physical world). The default value is DS3D_DEFAULTDOPPLERFACTOR (1.0). For additional information about Doppler factor, see Doppler Factor.