Microsoft DirectX 8.0 (C++) |
Converts a performance time in MUSIC_TIME format to performance time in REFERENCE_TIME format.
HRESULT MusicToReferenceTime( MUSIC_TIME mtTime, REFERENCE_TIME* prtTime );
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the following error values:
E_POINTER |
DMUS_E_NO_MASTER_CLOCK |
Because reference time has a greater precision than music time, a time that has been converted from reference time to music time, and then back again, probably does not have its original value.
This method converts a time offset from the start of the performance, not a duration. Because the ratio between music time and reference time units depends on the tempo, DirectMusic takes into account all tempo changes since the start of the performance when calculating prtTime. If a master tempo has been set for the performance, it is taken into account as well.
Header: Declared in dmusici.h.
IDirectMusicPerformance8::ReferenceToMusicTime, Clock Time vs. Music Time