Microsoft DirectX 9.0

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 device object associated with this buffer.

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 Initialize internally, applications do not need to call this method.

Requirements

  Header: Declared in dsound.h.

See Also