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:

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.