CSystemClock.SetClockDelta method
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The SetClockDelta method adjusts the clock time. This method implements the IAMClockAdjust::SetClockDelta method.
Syntax
HRESULT SetClockDelta(
REFERENCE_TIME rtDelta
);
Parameters
-
rtDelta
-
Specifies the amount by which to adjust the clock, as a REFERENCE_TIME value. A positive value moves the clock forward, and a negative value moves the clock backward.
Return value
Returns S_OK or an HRESULT error code.
Remarks
This method simply calls CBaseReferenceClock::SetTimeDelta.
The time values returned by IReferenceClock::GetTime are monotonically increasing. If you set the clock back, GetTime continues to report the old time until the internal clock catches up.
Requirements
| Requirement | Value |
|---|---|
| Version |
CSystemClock Class |
| Header |
|
| Library |
|