Microsoft DirectX 8.0 (C++) |
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;
Header: Declared in dsound.h.
Obtaining the 3-D Buffer Object, Retrieving Objects from an Audiopath