Microsoft DirectX 8.1 (C++)

IDirectSound3DBuffer8

The IDirectSound3DBuffer8 interface is used to retrieve and set parameters that describe the position, orientation, and environment of a sound buffer in 3-D space.

IDirectSound3DBuffer8 is a define for IDirectSoundBuffer. The two interface names are interchangeable.

The IDirectSound3DBuffer8 interface is obtained from an IDirectSoundBuffer8 interface by using the IDirectSoundBuffer8::QueryInterface method. It can also be retrieved from an audiopath.

In addition to the methods inherited from IUnknown, the IDirectSound3DBuffer8 interface exposes the following methods.

3-D mode

Method Description
GetMode Retrieves the operation mode for 3-D sound processing.
SetMode Sets the operation mode for 3-D sound processing.

Batch parameters

Method Description
GetAllParameters Retrieves information that describes the 3-D characteristics of a sound buffer at a given point in time.
SetAllParameters Sets all 3-D sound buffer parameters.

Minimum and maximum distance

Method Description
GetMaxDistance Retrieves the maximum distance for this sound buffer.
GetMinDistance Retrieves the minimum distance for this sound buffer.
SetMaxDistance Sets the maximum distance value.
SetMinDistance Sets the minimum distance value.

Position

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

Sound projection cone

Method Description
GetConeAngles Retrieves the inside and outside angles of the sound projection cone for this sound buffer.
GetConeOrientation Retrieves the orientation of the sound projection cone for this sound buffer.
GetConeOutsideVolume Retrieves the cone outside volume for this sound buffer.
SetConeAngles Sets the inside and outside angles of the sound projection cone for this sound buffer.
SetConeOrientation Sets the orientation of the sound projection cone for this sound buffer.
SetConeOutsideVolume Sets the cone outside volume for this sound buffer.

Velocity

Method Description
GetVelocity Retrieves the velocity for this sound buffer.
SetVelocity Sets the velocity of the sound source.

The LPDIRECTSOUND3DBUFFER type is defined as a pointer to the IDirectSound3DBuffer8 interface:

typedef struct IDirectSound3DBuffer  *LPDIRECTSOUND3DBUFFER;

Requirements

  Header: Declared in dsound.h.

See Also