Platform SDK: DirectX

DirectMusicPerformance.GetGrooveLevel

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

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

パラメータ

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

戻り値

成功すれば 1 〜 100 の範囲で値を返す。

エラー コード

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

DMUS_E_NO_MASTER_CLOCK
DMUS_E_GET_UNSUPPORTED
DMUS_E_NOT_FOUND
DMUS_E_TRACK_NOT_FOUND

注意

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

参照

CONST_DMUS_SEGF_FLAGS