Platform SDK: DirectX |
DirectMusicPerformance.GetGrooveLevel メソッドは、パフォーマンスの制御セグメントからグルーブ レベルを取り出す。グルーブ レベルによって、指定のタイムに演奏できるパターンが決まる。
object.GetGrooveLevel(mtTime As Long, _ mtUntil As Long) As Byte
成功すれば 1 〜 100 の範囲で値を返す。
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DMUS_E_NO_MASTER_CLOCK |
DMUS_E_GET_UNSUPPORTED |
DMUS_E_NOT_FOUND |
DMUS_E_TRACK_NOT_FOUND |
通常、プライマリ セグメントは制御セグメントである。ただし、セカンダリ セグメントを演奏するときは、これを制御セグメントとして指定できる。別の制御セグメントが挿入される場合、このメソッドによって返されるオブジェクトは、mtUntil に返されるタイムの前に無効になることがある。