The IDirectSoundCapture::CreateCaptureBuffer method creates a capture buffer.
Unlike DirectSound, which can mix several sounds into one sound for output, DirectSoundCapture cannot do the exact opposite and extract various sounds from one input sound. For the first version, DirectSoundCapture allows only one capture buffer to exist at any given time per capture device.
HRESULT CreateCaptureBuffer(
LPDSCBUFFERDESC lpDSCBufferDesc,
LPLPDIRECTSOUNDCAPTUREBUFFER lplpDirectSoundCaptureBuffer,
LPUNKNOWN pUnkOuter
);
If the method succeeds, the return value is DS_OK.
If the method fails, the return value may be one of the following error values:
DSERR_INVALIDPARAM
DSERR_BADFORMAT
DSERR_GENERIC
DSERR_NODRIVER
DSERR_OUTOFMEMORY
DSERR_UNINITIALIZED
Windows NT: Use version 5.0 or later.
Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
Windows CE: Unsupported.
Header: Declared in dsound.h.
Import Library: Use dsound.lib.