Microsoft DirectX 9.0

IDirectSound3DListener8 Interface

The IDirectSound3DListener8 interface is used to retrieve and set parameters that describe a listener's position, orientation, and listening environment in 3-D space.

The interface can be obtained by calling the IDirectSoundBuffer8::QueryInterface method on a primary buffer created with the DSBCAPS_CTRL3D flag.

In addition to the methods inherited from IUnknown, the IDirectSound3DListener8 interface exposes the following methods, arranged by category.

Batch parameters

Method Description
CommitDeferredSettings Commits any deferred settings made since the last call to this method.
GetAllParameters Retrieves all 3-D parameters of the sound environment and the listener.
SetAllParameters Sets all 3-D parameters of the sound environment and the listener.

Global sound properties

Method Description
GetDistanceFactor Retrieves the distance factor, which is the number of meters in a vector unit.
GetDopplerFactor Retrieves the multiplier for the Doppler effect.
GetRolloffFactor Retrieves the rolloff factor, which determines the rate of attenuation over distance.
SetDistanceFactor Sets the distance factor.
SetDopplerFactor Sets the multiplier for the Doppler effect.
SetRolloffFactor Sets the rolloff factor.

Listener properties

Method Description
GetOrientation Retrieves the orientation of the listener's head.
GetPosition Retrieves the listener's position.
GetVelocity Retrieves the listener's velocity.
SetOrientation Sets the orientation of the listener's head.
SetPosition Sets the listener's position.
SetVelocity Sets the listener's velocity.

The LPDIRECTSOUND3DLISTENER type is defined as a pointer to the IDirectSound3DListener interface:

typedef struct IDirectSound3DListener  *LPDIRECTSOUND3DLISTENER;

Requirements

  Header: Declared in dsound.h.

See Also