IDirectMusicPerformance::ReferenceToMusicTime

The IDirectMusicPerformance::ReferenceToMusicTime method converts time in REFERENCE_TIME format to time in MUSIC_TIME format.

HRESULT ReferenceToMusicTime(
  REFERENCE_TIME rtTime,
  MUSIC_TIME* pmtTime
);

Parameters

rtTime

Time in REFERENCE_TIME format.

pmtTime

Address of a variable to receive the converted time in MUSIC_TIME format.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return one of the following error values:

Remarks

If a master tempo has been set for the performance, it is taken into account when converting to music time. See Setting and Retrieving Global Parameters.

Because music time is less precise than reference time, rounding off occurs.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusici.h.

See Also

IDirectMusicPerformance::MusicToReferenceTime, Clock Time vs. Music Time