Microsoft DirectX 9.0

IDirectMusicPort8::PlayBuffer

The PlayBuffer method cues a buffer for playback by the port.

Syntax

HRESULT PlayBuffer(
  LPDIRECTMUSICBUFFER pBuffer
);

Parameters

pBuffer

Address of an IDirectMusicBuffer8 interface pointer of the buffer to be added to the port's playback queue.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return one of the error values shown in the following table.

Return code
E_FAIL
E_INVALIDARG
E_NOTIMPL
E_OUTOFMEMORY

Remarks

The buffer is in use by the system only for the duration of this method and can be reused after the method returns.

If no start time has been set by using the IDirectMusicBuffer8::SetStartTime method, the start time is the time of the earliest event in the buffer, as set by the IDirectMusicBuffer8::PackStructured or the IDirectMusicBuffer8::PackUnstructured method.

Requirements

  Header: Declared in dmusicc.h.

See Also