DirectSoundCaptureCreate

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

HRESULT WINAPI DirectSoundCaptureCreate(
  LPCGUID lpcGUID,                 
  LPDIRECTSOUNDCAPTURE *lplpDSC,  
  LPUNKNOWN pUnkOuter             
);

Parameters

lpcGUID

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:

Remarks

On sound card that do not support full duplex, this method will fail and return DSERR_ALLOCATED.

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.