Microsoft DirectX 8.1 (C++)

IDirectSoundBuffer8::Initialize

The Initialize method initializes a sound buffer object if it has not yet been initialized.

Syntax

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.

Return code
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