IMFClockStateSink::OnClockRestart method (mfidl.h)

Article
02/22/2024

Called when the presentation clock restarts from the same position while paused.

Syntax

HRESULT OnClockRestart(
  [in] MFTIME hnsSystemTime
);

Parameters

[in] hnsSystemTime

The system time when the clock restarted, in 100-nanosecond units.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method is called if the presentation clock is paused and the IMFPresentationClock::Start method is called with the value PRESENTATION_CURRENT_POSITION.

The clock notifies the presentation time source by calling the time source's OnClockRestart method. This call occurs synchronously within the Start method. If the time source returns an error from OnClockRestart, the presentation clock's Start method returns an error and the state change does not take place.

For any object that is not the presentation time source, the OnClockRestart method is called asynchronously, after the state change is completed. In that case, the return value from this method is ignored.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps \| UWP apps]
Target Platform	Windows
Header	mfidl.h
Library	Mfuuid.lib