Platform SDK: DirectX |
Applications use the methods of the DirectSound3DListener class 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 class.
An object of this class is obtained by using the DirectSoundBuffer.GetDirectSound3DListener method. The buffer from which the listener is obtained must have been created with the DSBCAPS_PRIMARYBUFFER flag. The listener can also be obtained by calling the DirectSound3DBuffer.GetDirectSound3DListener method on a DirectSound3DBuffer object obtained from the primary buffer.
The methods of the DirectSound3DListener class can be organized into the following groups.
Batch parameters | GetAllParameters |
SetAllParameters | |
Deferred settings | CommitDeferredSettings |
Distance factor | GetDistanceFactor |
SetDistanceFactor | |
Doppler factor | GetDopplerFactor |
SetDopplerFactor | |
Obtaining objects | GetDirectSoundBuffer |
Orientation | GetOrientation |
SetOrientation | |
Position | GetPosition |
SetPosition | |
Rolloff factor | GetRolloffFactor |
SetRolloffFactor | |
Velocity | GetVelocity |
SetVelocity |