Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::ReferenceToMusicTime

REFERENCE_TIME フォーマットのパフォーマンス タイムを MUSIC_TIME フォーマットに変換する。

HRESULT ReferenceToMusicTime(
  REFERENCE_TIME rtTime,
  MUSIC_TIME* pmtTime
);

パラメータ

rtTime
REFERENCE_TIME フォーマットの時間。
pmtTime
MUSIC_TIME フォーマットに変換された時間を受け取る変数のアドレス。

戻り値

成功した場合は S_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

E_POINTER
DMUS_E_NO_MASTER_CLOCK

注意

ミュージック タイムは基準タイムほど正確ではないため、切り捨てが行われる。

このメソッドは、パフォーマンスの時間ではなく、パフォーマンスの開始からのタイムのオフセットを変換する。ミュージック タイムと基準タイムの単位の比率は、テンポにより異なるので、prtTime を計算する際に、DirectMusic はパフォーマンス開始以降のあらゆるテンポの変更を考慮する。パフォーマンスについてマスタ テンポが設定されている場合は、同様に考慮される。

動作環境

  ヘッダー : dmusici.h で宣言。

参照

IDirectMusicPerformance8::MusicToReferenceTimeクロック タイムとミュージック タイム