|Microsoft DirectX 9.0|
The IDirectSound3DBuffer8 interface is 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 IDirectSound3DBuffer. The two interface names are interchangeable.
The IDirectSound3DBuffer8 interface is obtained from a buffer that was created with the DSBCAPS_CTRL3D flag. You can get it from the IDirectSoundBuffer8 interface by using the QueryInterface method, or retrieve it from an audiopath by using IDirectMusicSegmentState8::GetObjectInPath or IDirectMusicAudioPath8::GetObjectInPath.
In addition to the methods inherited from IUnknown, the IDirectSound3DBuffer8 interface exposes the following methods, arranged by category.
|GetMode||Retrieves the operation mode for 3-D sound processing.|
|SetMode||Sets the operation mode for 3-D sound processing.|
|GetAllParameters||Retrieves all 3-D properties of the sound buffer.|
|SetAllParameters||Sets all 3-D properties of the sound buffer.|
|GetMaxDistance||Retrieves the maximum distance, which is the distance from the listener beyond which sounds in this buffer are no longer attenuated.|
|GetMinDistance||Retrieves retrieves the minimum distance, which is the distance from the listener at which sounds in this buffer begin to be attenuated.|
|SetMaxDistance||Sets the maximum distance.|
|SetMinDistance||Sets the minimum distance.|
|GetPosition||Retrieves the position of the sound source.|
|SetPosition||Sets the position of the sound source.|
|GetConeAngles||Retrieves the inside and outside angles of the sound projection cone.|
|GetConeOrientation||Retrieves the orientation of the sound projection cone.|
|GetConeOutsideVolume||Retrieves the volume of the sound outside the outside angle of the sound projection cone.|
|SetConeAngles||Sets the inside and outside angles of the sound projection cone.|
|SetConeOrientation||Sets the orientation of the sound projection cone.|
|SetConeOutsideVolume||Sets the volume of the sound outside the outside angle of the sound projection cone.|
|GetVelocity||Retrieves the velocity of the sound source.|
|SetVelocity||Sets the velocity of the sound source.|
The LPDIRECTSOUND3DBUFFER type is defined as a pointer to the IDirectSound3DBuffer8 interface:
typedef struct IDirectSound3DBuffer *LPDIRECTSOUND3DBUFFER;
Header: Declared in dsound.h.