DirectX SDK

IDirectSound3DBuffer

Applications use the methods of the IDirectSound3DBuffer interface to retrieve and set parameters that describe the position, orientation, and environment of a sound buffer in 3-D space. This section is a reference to the methods of this interface. For a conceptual overview, see DirectSound 3-D Buffers.

The IDirectSound3DBuffer is obtaining by using the IDirectSoundBuffer::QueryInterface method. For more information, see Obtaining the DirectSound3DBuffer Object.

The methods of the IDirectSound3DBuffer 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 IDirectSound3DBuffer 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 IDirectSound3DBuffer interface:

typedef struct IDirectSound3DBuffer    *LPDIRECTSOUND3DBUFFER;

Requirements

  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.