IDirectSoundCaptureBuffer::Initialize

  • Article

This method initializes a DirectSoundCaptureBuffer object if it has not yet been initialized.

HRESULT Initialize( 
  LPDIRECTSOUNDCAPTURE lpDirectSoundCapture, 
  LPCDSBUFFERDESC lpcDSBufferDesc 
);

Parameters

  • lpDirectSoundCapture
    Address of the DirectSoundCapture object associated with this DirectSoundCaptureBuffer object.
  • lpcDSBufferDesc
    Address of a DSBUFFERDESC structure that contains the values used to initialize this sound buffer.

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_ALREADYINITIALIZED

Remarks

Because the IDirectSoundCapture::CreateCaptureBuffer method calls the IDirectSoundCaptureBuffer::Initialize method internally, it is not needed for the current release of DirectSound. This method is provided for future extensibility.

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

DSBUFFERDESC | IDirectSoundCapture::CreateCaptureBuffer

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.