Microsoft DirectX 8.0 (Visual Basic) |
Retrieves the groove level from the performance's control segment. The groove level determines which patterns can be played at the specified time.
object.GetGrooveLevel( _ mtTime As Long, _ mtUntil As Long _ ) As Byte
Returns a value in the range from 1 through 100.
If the method fails, it raises an error, and Err.Number can be set to one of the following error codes:
DMUS_E_NO_MASTER_CLOCK |
DMUS_E_GET_UNSUPPORTED |
DMUS_E_NOT_FOUND |
DMUS_E_TRACK_NOT_FOUND |
Normally the primary segment is the control segment. However, a secondary segment can be designated as a control segment when it is played. The object returned by the method can become invalid before the time returned in mtUntil if another control segment is cued.
DirectMusicPerformance8.GetMasterGrooveLevel, CONST_DMUS_SEGF_FLAGS