DirectSoundCaptureCreate

The DirectSoundCaptureCreate 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:

QuickInfo

  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.