Microsoft DirectX 8.0 (C++)

IDirectSound3DBuffer8

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 audio path.

The methods of the IDirectSound3DBuffer8 interface can be organized into the following groups:

Batch parameter manipulation GetAllParameters
  SetAllParameters
Distance GetMaxDistance
  GetMinDistance
  SetMaxDistance
  SetMinDistance
Operation mode GetMode
  SetMode
Position GetPosition
  SetPosition
Sound projection cones GetConeAngles
  GetConeOrientation
  GetConeOutsideVolume
  SetConeAngles
  SetConeOrientation
  SetConeOutsideVolume
Velocity GetVelocity
  SetVelocity

The IDirectSound3DBuffer8 interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:

IUnknown AddRef
  QueryInterface
  Release

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

typedef struct IDirectSound3DBuffer    *LPDIRECTSOUND3DBUFFER;

Requirements

  Header: Declared in dsound.h.

See Also

Obtaining the 3-D Buffer Object, Retrieving Objects from an Audiopath