Platform SDK: DirectX

IDirectSoundCapture::CreateCaptureBuffer

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  
);

Parameters

lpDSCBufferDesc
Pointer to a DSCBUFFERDESC structure containing values for the capture buffer being created.
lplpDirectSoundCaptureBuffer
Address of the IDirectSoundCaptureBuffer interface pointer if successful.
pUnkOuter
Controlling IUnknown of the aggregate. Its value must be NULL.

Return Values

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

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dsound.h.
  Import Library: Use dsound.lib.