| 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.
| Method | Description |
| GetMode | Retrieves the operation mode for 3-D sound processing. |
| SetMode | Sets the operation mode for 3-D sound processing. |
| Method | Description |
| GetAllParameters | Retrieves all 3-D properties of the sound buffer. |
| SetAllParameters | Sets all 3-D properties of the sound buffer. |
| Method | Description |
| 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. |
| Method | Description |
| GetPosition | Retrieves the position of the sound source. |
| SetPosition | Sets the position of the sound source. |
| Method | Description |
| 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. |
| Method | Description |
| 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;
Requirements
Header: Declared in dsound.h.
See Also