Поделиться через


Метод IMFClockStateSink::OnClockStart (mfidl.h)

Вызывается при запуске часов презентации.

Синтаксис

HRESULT OnClockStart(
  [in] MFTIME   hnsSystemTime,
  [in] LONGLONG llClockStartOffset
);

Параметры

[in] hnsSystemTime

Системное время запуска часов в 100-наносекундных единицах.

[in] llClockStartOffset

Новое время начала часов в 100-наносекундных единицах. Этот параметр также может быть равен PRESENTATION_CURRENT_POSITION, указывая, что часы запущены или перезапущены из текущей позиции.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод вызывается при вызове метода IMFPresentationClock::Start в часах представления, за исключением следующего: если часы приостановлены, а функция Start вызывается со значением PRESENTATION_CURRENT_POSITION, вместо OnClockStart вызывается IMFClockStateSink::OnClockRestart.

Часы уведомляют источник времени презентации, вызывая метод OnClockStart источника времени. Этот вызов выполняется синхронно в методе Start . Если источник времени возвращает ошибку из OnClockStart, метод Start для часов представления возвращает ошибку, а изменение состояния не происходит.

Для любого объекта, который не является источником времени представления, метод OnClockStart вызывается асинхронно после изменения состояния. В этом случае возвращаемое значение из этого метода игнорируется.

Значение, заданное в параметре llClockStartOffset , — это время презентации, когда начинаются часы, поэтому оно относительно начала презентации. Приемники мультимедиа не должны отрисовываться какие-либо данные со временем представления, предшествующим llClockStartOffSet. Если пример перестраивает смещение( то есть, если смещение находится между временем начала и остановки примера), приемник должен либо обрезать образец таким образом, чтобы отрисовывался только данные после llClockStartOffset , либо просто удалить пример.

Требования

   
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfidl.h
Библиотека Mfuuid.lib

См. также раздел

IMFClockStateSink

MFTIME

Часы презентации