Platform SDK: DirectX

DirectMusicPerformance.GetQueueTime

The DirectMusicPerformance.GetQueueTime method retrieves the current queue (or flush) time. Messages that have time stamps earlier than this time have already been queued to the port and cannot be invalidated.

object.GetQueueTime() As Long

Parameters

object
Object expression that resolves to a DirectMusicPerformance object.

Return Values

If the method succeeds, it returns the queue time, in clock time units.

Error Codes

If the method fails, it raises an error, and Err.Number can be set to DMUS_E_NO_MASTER_CLOCK.

Remarks

Queue time is equal to the value returned by DirectMusicPerformance.GetLatencyTime plus the value returned by DirectMusicPerformance.GetBumperLength.

When a segment is stopped immediately, all messages that have been sent but not queued to the port buffer are flushed. If you want to resume playing the segment again at the last point heard, set the new start point to the offset of queue time within the segment when the segment was stopped.

See Also

DirectMusicPerformance.Invalidate