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:** Dmusicc.h
See Also