| Microsoft DirectX 9.0 SDK Update (Summer 2004) |
IDirectMusicPerformance8::MusicToReferenceTime
The MusicToReferenceTime method converts a performance time in MUSIC_TIME format to performance time in REFERENCE_TIME format.
Syntax
HRESULT MusicToReferenceTime(
MUSIC_TIME mtTime,
REFERENCE_TIME* prtTime
);
Parameters
mtTime
Time in MUSIC_TIME format to convert.
prtTime
Address of a variable that receives the converted time in REFERENCE_TIME format.
Return Values
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the error values shown in the following table.
| Return code |
| E_POINTER |
| DMUS_E_NO_MASTER_CLOCK |
Remarks
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.
Requirements
Header: Declared in dmusici.h.
See Also
- Clock Time and Music Time
- IDirectMusicPerformance8 Interface
- IDirectMusicPerformance8::ReferenceToMusicTime
© 2004 Microsoft Corporation. All rights reserved.