Microsoft DirectX 8.1 (Visual Basic)

DirectMusicPerformance8.GetQueueTime

The GetQueueTime method retrieves the 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

Parts

object

Resolves to a DirectMusicPerformance8 object.

Return Values

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 DirectMusicPerformance8.GetLatencyTime plus the value returned by DirectMusicPerformance8.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