Microsoft DirectX 8.1 (C++)

IDirectSoundFullDuplex8::Initialize

The Initialize method initializes a full duplex object that was created by using CoCreateInstance.

Syntax

HRESULT Initialize(
  LPCGUID  pCaptureGuid, 
  LPCGUID  pRenderGuid, 
  LPCDSCBUFFERDESC  lpDscBufferDesc, 
  LPCDSBUFFERDESC  lpDsBufferDesc,
  HWND  hWnd, 
  DWORD  dwLevel, 
  LPLPDIRECTSOUNDCAPTUREBUFFER8  lplpDirectSoundCaptureBuffer8, 
  LPLPDIRECTSOUNDBUFFER8  lplpDirectSoundBuffer8
);

Parameters

pCaptureGuid

Address of the GUID that identifies the sound capture device for full duplex input. Must be one of the GUIDs returned by DirectSoundCaptureEnumerate, NULL for the default capture device, or one of the following values.

Value Description
DSDEVID_DefaultCapture System-wide default audio capture device.
DSDEVID_DefaultVoiceCapture Default voice capture device.

pRenderGuid

Address of the GUID that identifies the sound render device for full-duplex output. Must be one of the GUIDs returned by DirectSoundEnumerate, NULL for the default render device, or one of the following values:

Value Description
DSDEVID_DefaultPlayback System-wide default audio playback device.
DSDEVID_DefaultVoicePlayback Default voice playback device.

lpDscBufferDesc

Address of a DSCBUFFERDESC structure that specifies the characteristics of the capture buffer.

lpDsBufferDesc

Address of a DSBUFFERDESC structure that specifies the characteristics of the render buffer.

hWnd

Handle to the application window.

dwLevel

Cooperative level for the DirectSound object. For more information, see IDirectSound8::SetCooperativeLevel.

lplpDirectSoundCaptureBuffer8

Address of a variable that receives the IDirectSoundCaptureBuffer8 interface of the capture buffer.

lplpDirectSoundBuffer8

Address of a variable that receives the IDirectSoundBuffer8 interface of the render buffer.

Return Values

If the method succeeds, the return value is DS_OK.

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

Return code
DSERR_ALREADYINITIALIZED
DSERR_BADFORMAT
DSERR_GENERIC
DSERR_INVALIDPARAM
DSERR_NODRIVER
DSERR_OUTOFMEMORY
DSERR_UNINITIALIZED

Requirements

  Header: Declared in dsound.h.

See Also