Platform SDK: DirectX |
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;
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.