Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::MusicToReferenceTime

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

HRESULT MusicToReferenceTime(
  MUSIC_TIME mtTime,
  REFERENCE_TIME* prtTime
);

パラメータ

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

戻り値

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

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

E_POINTER
DMUS_E_NO_MASTER_CLOCK

注意

基準タイムはミュージック タイムよりも正確であるため、基準タイムからミュージック タイムに変換し、また基準タイムに変換したタイムは、おそらく元の値とは異なる。

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

動作環境

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

参照

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