IDirectSoundCapture::CreateCaptureBuffer

This 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

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Dsound.h.
Link Library: Dsound.lib.

See Also

DSCBUFFERDESC

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.