Platform SDK: DirectX

DirectMusicPerformance.GetTempo

DirectMusicPerformance.GetTempo メソッドは、指定されたタイムのテンポを取り出す。

object.GetTempo(mtTime As Long, mtUntil As Long) As Double

パラメータ

object
DirectMusicPerformance オブジェクトを表すオブジェクト式。
mtTime
テンポが取り出されるタイム。ミュージック タイムで指定する。このタイムまたはこれより前に行われたテンポの最後の変更を使って、テンポが決まる。
mtUntil
テンポが有効になるミュージック タイム (mtTime からの相対タイム) を受け取る変数のアドレス。この変数が値 0 を返した場合、テンポが常に有効になっているか、テンポが無効になるタイムが不明であることを意味する。

戻り値

成功すれば、テンポを 1 分あたりの拍数で返す。この値は DMUS_TEMPO_MIN 〜 DMUS_TEMPO_MAX の範囲にある (「CONST_DMUS」を参照)。

エラー コード

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

DMUS_E_NO_MASTER_CLOCK
DMUS_E_GET_UNSUPPORTED
DMUS_E_NOT_FOUND
DMUS_E_TRACK_NOT_FOUND