Microsoft DirectX 8.0 (Visual Basic)

DirectMusicPerformance8.GetGrooveLevel

パフォーマンスの制御セグメントからグルーブ レベルを取得する。グルーブ レベルによって、指定のタイムに演奏できるパターンが決まる。

object.GetGrooveLevel( _
  mtTime As Long, _
  mtUntil As Long _
) As Byte

指定項目

object
DirectMusicPerformance8 オブジェクトを指定する。
mtTime
グルーブ レベルが取得されるタイム。ミュージック タイムで指定する。
mtUntil
そのグルーブ レベルが無効になるミュージック タイム (mtTime からの相対タイム) を受け取る、長整数型 (Long) の変数。この変数が値 0 を返した場合、グルーブ レベルが常に有効になっているか、グルーブ レベルが無効になるタイムが不明であることを意味する。「注意」を参照すること。

戻り値

1 から 100 までの範囲の値を返す。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。

DMUS_E_NO_MASTER_CLOCK
DMUS_E_GET_UNSUPPORTED
DMUS_E_NOT_FOUND
DMUS_E_TRACK_NOT_FOUND

注意

通常、プライマリ セグメントは制御セグメントである。ただし、セカンダリ セグメントを演奏するときは、これを制御セグメントとして指定できる。別の制御セグメントが挿入される場合、このメソッドによって返されるタイムは、mtUntil に返されるタイムの前に無効になることがある。

参照

DirectMusicPerformance8.GetMasterGrooveLevelCONST_DMUS_SEGF_FLAGS