IDirectSoundBuffer::Initialize

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

HRESULT Initialize( 
  LPDIRECTSOUND lpDirectSound, 
  LPCDSBUFFERDESC lpcDSBufferDesc 
);

Parameters

  • lpDirectSound
    Address of the DirectSound object associated with this DirectSoundBuffer 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 IDirectSound::CreateSoundBuffer method calls IDirectSoundBuffer::Initialize 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

IDirectSoundBuffer | DirectSound::CreateSoundBuffer | DSBUFFERDESC

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.