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 IDirectSound3DBuffer Interface.
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;
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.