IAMClockAdjust::SetClockDelta method (strmif.h)
[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.
Syntax
HRESULT SetClockDelta(
[in] REFERENCE_TIME rtDelta
);
Parameters
[in] 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
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 |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |
| Library | Strmiids.lib |