KSDSOUND_BUFFERDESC

The KSDSOUND_BUFFERDESC structure describes a DirectSound buffer.

typedef struct
{
  ULONG  Flags;
  ULONG  Control;
  WAVEFORMATEX  WaveFormatEx;
} KSDSOUND_BUFFERDESC, *PKSDSOUND_BUFFERDESC;

Members

Flags

Specifies the buffer configuration. This member can be set to the bitwise OR of one or more of the following flag bits:

KSDSOUND_BUFFER_PRIMARY: Indicates that the buffer is a primary sound buffer (the buffer the user hears when a game is playing).
KSDSOUND_BUFFER_STATIC: Indicates that the buffer will be used for static sound data.
KSDSOUND_BUFFER_LOCHARDWARE: Forces the buffer to use hardware mixing.
KSDSOUND_BUFFER_LOCSOFTWARE: Forces the buffer to be stored in system memory and use software mixing.

Control

Specifies the capabilities of the buffer. The capabilities of a buffer are represented by a set of control flags. This member can be set to the bitwise OR of one or more of the following flag bits:

KSDSOUND_BUFFER_CTRL_3D: Indicates that the buffer is either a primary buffer or a secondary buffer that uses 3D control.
KSDSOUND_BUFFER_CTRL_FREQUENCY: Indicates that the buffer has frequency-control capability.
KSDSOUND_BUFFER_CTRL_PAN: Indicates that the buffer has pan-control capability.
KSDSOUND_BUFFER_CTRL_VOLUME: Indicates that the buffer has volume-control capability.
KSDSOUND_BUFFER_CTRL_POSITIONNOTIFY: Indicates that the buffer has position-notification capability.

WaveFormatEx

Specifies the wave-data format of the buffer. This member is a structure of type WAVEFORMATEX.

Headers

Declared in ksmedia.h. Include ksmedia.h.

Comments

The KSDATAFORMAT_DSOUND structure contains a BufferDesc member that is a KSDSOUND_BUFFERDESC structure.

Note that the WaveFormatEx member of the KSDSOUND_BUFFERDESC structure can be extended to include additional format information (for example, a channel configuration mask). For details, see WAVEFORMATEXTENSIBLE.

KSDSOUND_BUFFERDESC

Members

Headers

Comments

See Also