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 parameters | GetAllParameters |
| 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:
| IUnknown | AddRef |
| QueryInterface | |
| Release |
The LPDIRECTSOUND3DLISTENER type is defined as a pointer to the IDirectSound3DListener interface:
typedef struct IDirectSound3DListener *LPDIRECTSOUND3DLISTENER;
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in dsound.h.
Import Library: Use dsound.lib.