Microsoft DirectX 8.1 (Visual Basic) |
The GetTimeSig method retrieves the time signature at a given time.
object.GetTimeSig( _
mtTime As Long, _
mtUntil As Long, _
timeSig As DMUS_TIMESIGNATURE)
Parts
object
Resolves to a DirectMusicPerformance8 object.
mtTime
Value that specifies the time for which to retrieve the time signature, in music time. The last time signature change before or at this time is used to determine the time signature.
mtUntil
Variable of type Long that receives the music time (relative to mtTime) until which the time signature is valid. If this returns a value of 0, either the time signature is always valid, or it is unknown when it might become invalid. See Remarks.
timeSig
DMUS_TIMESIGNATURE type that receives information about the time signature. The mtTime member receives the offset of the last time signature change from the requested time, and is always 0 or less.
Error Codes
If the method fails, it raises an error, and Err.Number can be set to one of the following values:
DMUS_E_NO_MASTER_CLOCK |
DMUS_E_GET_UNSUPPORTED |
DMUS_E_NOT_FOUND |
DMUS_E_TRACK_NOT_FOUND |