Platform SDK: DirectX

IDirectSoundCapture::Initialize

When CoCreateInstance is used to create a DirectSoundCapture object, the object must be initialized with the IDirectSoundCapture::Initialize method. Calling this method is not required when the DirectSoundCaptureCreate function is used to create the object.

HRESULT Initialize(
  LPCGUID lpcGuid  
);

Parameters

lpcGuid
Address of the GUID specifying the sound driver to which the DirectSoundCapture object binds. Use NULL to select the primary sound driver.

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_NODRIVER
DSERR_OUTOFMEMORY
DSERR_ALREADYINITIALIZED

Remarks

The lpcGuid parameter has changed from a LPGUID to a LPCGUID in DirectX 7.0.

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.