Applications use the methods of the IDirectSound3DListener interface to retrieve and set parameters that describe a listener's position, orientation, and listening environment in 3-D space. This section is a reference to the methods of this interface. For a conceptual overview, see DirectSound 3-D Listeners.
The interface is obtained by using the IDirectSoundBuffer::QueryInterface method. For more information, see Obtaining the IDirectSound3DListener Interface.
The methods of the IDirectSound3DListener interface can be organized into the following groups:
| Batch parameter | GetAllParameters |
| manipulation | SetAllParameters |
| Deferred settings | CommitDeferredSettings |
| Distance factor | GetDistanceFactor |
| SetDistanceFactor | |
| Doppler factor | GetDopplerFactor |
| SetDopplerFactor | |
| Orientation | GetOrientation |
| SetOrientation | |
| Position | GetPosition |
| SetPosition | |
| Rolloff factor | GetRolloffFactor |
| SetRolloffFactor | |
| Velocity | GetVelocity |
| SetVelocity | |
The IDirectSound3DListener interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:
The LPDIRECTSOUND3DLISTENER type is defined as a pointer to the IDirectSound3DListener interface:
typedef struct IDirectSound3DListener *LPDIRECTSOUND3DLISTENER;