DirectX SDK

IDirectMusicPerformance::AdjustTime

The IDirectMusicPerformance::AdjustTime method adjusts the internal performance time forward or backward. This is mostly used to compensate for drift when synchronizing to another source.

HRESULT AdjustTime(
  REFERENCE_TIME rtAmount
);

Parameters

rtAmount
Amount of time to add or subtract. This can be a number from –10,000,000 through 10,000,000 (–1 second through +1 second).

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return E_INVALIDARG.

Remarks

The adjusted time is used internally by DirectMusic. It is not reflected in the time retrieved by the IDirectMusicPerformance::GetTime method.

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::GetTime, Timing