| Microsoft DirectX 9.0 |
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
In addition to the methods inherited from IUnknown, the IDirectSound3DListener8 interface exposes the following methods, arranged by category.
| 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. |
| 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. |
| 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