DSDM_SETFORMAT

This message sets the format of the sound buffer to the format described in the WAVEFORMATEX structure.

typedef struct {
  DWORD dwMsg;
  DWORD dwInstance;
  LPWAVEFORMATEX pWFX;
} DSDMP_SETFORMAT;

dwMsg
Equals DSDM_SETFORMAT.
dwInstance
DirectSoundBuffer instance data.
pWFX
Pointer to a WAVEFORMATEX structure that describes the new format desired for the sound buffer.

Returns DS_OK if successful, or one of the following error values otherwise.

Error value	Description
DSERR_INVALIDCALL	This call is not valid for the current state of this object.
DSERR_INVALIDPARAM	An invalid parameter was passed to the returning function.
DSERR_BADFORMAT	The specified format is not supported.

DirectSound guarantees that this message is never called when the buffer is playing.

OS Versions: Windows CE .NET 4.0 and later.
Header: Dsdriver.h.

Additional resources