Microsoft DirectX 8.0 (C++)

IDirectSoundBuffer8::Initialize

Initializes a DirectSoundBuffer object if it has not yet been initialized.

HRESULT Initialize(
  LPDIRECTSOUND pDirectSound, 
  LPCDSBUFFERDESC pcDSBufferDesc 
);

Parameters

pDirectSound
Address of the DirectSound object associated with this DirectSoundBuffer object.
pcDSBufferDesc
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 IDirectSound8::CreateSoundBuffer method calls IDirectSoundBuffer8::Initialize internally, it is not needed for the current release of DirectSound. This method is provided for future extensibility.

Requirements

  Header: Declared in dsound.h.

See Also

DSBUFFERDESC, IDirectSound8::CreateSoundBuffer, IDirectSoundBuffer8