Microsoft DirectX 8.1 (Visual Basic)

DirectSound3DListener8

The DirectSound3DListener8 class represents the position and orientation of the listener and controls global 3-D sound parameters.  For a conceptual overview, see DirectSound 3-D Listeners.

An object of the DirectSound3DListener8 class is obtained by using the DirectSoundPrimaryBuffer8.GetDirectSound3DListener method.

The methods of the DirectSound3DListener8 class can be organized into the following groups.

Batch parameters

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

Distance factor

Method Description
GetDistanceFactor Retrieves the distance factor, which is the number of meters in a vector unit.
SetDistanceFactor Sets the distance factor, which is the number of meters in a vector unit.

Doppler factor

Method Description
GetDopplerFactor Retrieves the Doppler effect factor.
SetDopplerFactor Sets the Doppler effect factor.

Orientation

Method Description
GetOrientation Retrieves the listener's orientation in vectors: a front vector and a top vector.
SetOrientation Sets the listener's orientation in terms of two vectors: a front vector and a top vector.

Position

Method Description
GetPosition Retrieves the listener's position in distance units.
SetPosition Sets the listener's position, in distance units.

Rolloff factor

Method Description
GetRolloffFactor Retrieves the rolloff factor, which determines the rate of attenuation over distance.
SetRolloffFactor Sets the rolloff factor, which determines the rate of attenuation over distance.

Velocity

Method Description
GetVelocity Retrieves the listener's velocity.
SetVelocity Sets the listener's velocity.

Miscellaneous

Method Description
GetDirectSoundBuffer Retrieves the primary buffer object.