Microsoft DirectX 8.0 (C++)

DSCBUFFERDESC

Describes a capture buffer. Used by the IDirectSoundCapture8::CreateCaptureBuffer method.

An earlier version of this structure, DSCBUFFERDESC1, is maintained in Dsound.h for compatibility with DirectX 7 and earlier.

typedef struct {
    DWORD           dwSize;
    DWORD           dwFlags;
    DWORD           dwBufferBytes;
    DWORD           dwReserved;
    LPWAVEFORMATEX  lpwfxFormat;
    DWORD           dwFXCount;
    LPDSCEFFECTDESC lpDSCFXDesc;
} DSCBUFFERDESC, *LPDSCBUFFERDESC;
 
typedef const DSCBUFFERDESC *LPCDSCBUFFERDESC;

Members

dwSize
Size of the structure, in bytes. This member must be initialized before the structure is used.
dwFlags
Specifies device capabilities. Can be zero or one or more of the following flag:
DSCBCAPS_CTRLFX
The buffer supports effects. See Remarks.
DSCBCAPS_WAVEMAPPED
The Win32 wave mapper will be used for formats not supported by the device.
dwBufferBytes
Size of capture buffer to create, in bytes.
dwReserved
Reserved for future use.
lpwfxFormat
Pointer to a WAVEFORMATEX structure containing the format in which to capture the data.
dwFXCount
Number of elements in the array pointed to by lpDSCFXDesc. Must be zero unless DSCBCAPS_CTRLFX is present in dwFlags.
lpDSCFXDesc
Address of an array of DSCEFFECTDESC structures that describe effects supported by hardware for the buffer. User-mode DMOs are not supported.

Remarks

The DSCBCAPS_CTRLFX flag is supported only on buffers created by an object of class CLSID_DirectSoundCapture8. If the IDirectSoundCapture8 interface was obtained from DirectSoundCaptureCreate8, this flag is supported; if it was obtained from the earlier DirectSoundCaptureCreate function, it is not.

Capture effects are not supported on current operating systems.

Requirements

  Header: Declared in dsound.h.