Share via


DirectSound Structures

[The feature associated with this page, DirectSound, is a legacy feature. It has been superseded by WASAPI and Audio Graphs. Media Casting have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Media Casting instead of DirectSound, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

This section contains reference information about structures provided by the Microsoft DirectSound API.

Structure Description
D3DVECTOR Describes a vector.
DS3DBUFFER Contains all information necessary to uniquely describe the location, orientation, and motion of a 3D sound buffer.
DS3DLISTENER Describes the 3D world parameters and position of the listener.
DSBCAPS Describes the capabilities of a DirectSound buffer object.
DSBPOSITIONNOTIFY Describes a notification position.
DSBUFFERDESC Describes the characteristics of a buffer.
DSCAPS Describes the capabilities of a device.
DSCBCAPS Describes the capabilities of a capture buffer.
DSCBUFFERDESC Describes a capture buffer.
DSCCAPS Describes the capabilities of a capture device.
DSCEFFECTDESC Contains parameters for an effect associated with a capture buffer.
DSCFXAec Contains parameters for acoustic echo cancellation in a capture buffer.
DSCFXNoiseSuppress Contains parameters for noise suppression in a capture buffer.
DSEFFECTDESC Describes an effect associated with a buffer.
DSFXI3DL2Reverb Contains parameters for an I3DL2 (Interactive 3D Audio Level 2) reverberation effect.
DSFXChorus Contains parameters for a chorus effect.
DSFXCompressor Contains parameters for a compression effect.
DSFXDistortion Contains parameters for a distortion effect.
DSFXEcho Contains parameters for an echo effect.
DSFXFlanger Contains parameters for a flange effect.
DSFXGargle Contains parameters for an amplitude modulation effect.
DSFXParamEq Contains parameters for a parametric equalizer effect.
DSFXWavesReverb Contains parameters for a Waves reverberation effect.
WAVEFORMATEX Defines the format of waveform-audio data.
WAVEFORMATEXTENSIBLE Defines the format of waveform-audio data for formats having more than two channels or higher resolutions than allowed by WAVEFORMATEX.

Note

The memory for all DirectX structures must be initialized to 0 before use. In addition, all structures that contain a dwSize member must set the member to the size of the structure, in bytes, before use. The following example performs these tasks on a common structure, DSCAPS:

 DSCAPS dscaps;   ZeroMemory(&dscaps, sizeof(dscaps)); dscaps.dwSize = sizeof(dscaps);