Метод 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 |