DirectSoundCaptureCreate

This function creates and initializes an object that supports the IDirectSoundCapture interface.

HRESULT WINAPI DirectSoundCaptureCreate( 
  LPGUID lpGUID, 
  LPDIRECTSOUNDCAPTURE* lplpDSC, 
  LPUNKNOWN pUnkOuter 
);

Parameters

  • lpGUID
    Address of the GUID that identifies the sound capture device. The value of this parameter must be one of the GUIDs returned by DirectSoundCaptureEnumerate, or NULL for the default device.
  • lplpDSC
    Address of a pointer to a DirectSoundCapture object created in response to this function.
  • pUnkOuter
    Controlling unknown of the aggregate. Its value must be NULL.

Return Values

If the function succeeds, the return value is DS_OK.

If the function fails, the return value may be one of the following error values:

DSERR_INVALIDPARAM
DSERR_NOAGGREGATION
DSERR_OUTOFMEMORY

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

DirectSoundCaptureEnumerate

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.