IDirectSoundCapture::CreateCaptureBuffer

  • Article

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:

DSERR_INVALIDPARAM
DSERR_BADFORMAT
DSERR_GENERIC
DSERR_NODRIVER
DSERR_OUTOFMEMORY
DSERR_UNINITIALIZED

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.