Unknown

previous page next page

BASS_MIDI_StreamGetEventsEx

Retrieves a portion of the events in a MIDI stream.

DWORD BASS_MIDI_StreamGetEventsEx(
    HSTREAM handle,
    int track,
    DWORD filter,
    BASS_MIDI_EVENT *events,
    DWORD start,
    DWORD count
);

Parameters

handle	The MIDI stream to get the events from.
track	The track to get the events from... 0 = 1st track, -1 = all tracks.
filter	The type of events to retrieve... 0 = all events. See BASS_MIDI_StreamEvent for a list of possible event types.
events	Pointer to an array to receive the events... NULL = get the number of events available in the specified range without getting the events themselves.
start	The first event to retrieve.
count	The maximum number of events to retrieve.

Return value

If successful, the number of events is returned, else -1 is returned. Use BASS_ErrorGetCode to get the error code.

Error codes

BASS_ERROR_HANDLE	handle is not valid.
BASS_ERROR_NOTAVAIL	The stream does not have an event sequence.
BASS_ERROR_ILLPARAM	track is not valid.

Remarks

This function is identical to BASS_MIDI_StreamGetEvents except that it can retrieve a portion of the events instead of all of them.

Example

Retrieve the first 10 events in the 1st track.

BASS_MIDI_EVENT events[10]; // event array
DWORD eventc=BASS_MIDI_StreamGetEvents(handle, 0, 0, events, 0, 10); // get the events