Метод IMFPresentationClock::Start (mfidl.h)
Запускает часы презентации.
Синтаксис
HRESULT Start(
[in] LONGLONG llClockStartOffset
);
Параметры
[in] llClockStartOffset
Начальное время начала в 100-наносекундных единицах. Во время вызова метода Start метод IMFPresentationClock::GetTime возвращает это значение, а оттуда увеличивается время часов. Если значение равно PRESENTATION_CURRENT_POSITION, часы начинаются с текущей позиции. Используйте это значение, если часы приостановлены и вы хотите перезапустить их из той же позиции.
Возвращаемое значение
Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
Код возврата | Описание |
---|---|
|
Метод выполнен успешно. |
|
Для этих часов не задан источник времени. |
Комментарии
Этот метод допустим во всех состояниях (остановлен, приостановлен или запущен).
Если часы приостановлены и перезапущены из той же позиции (значение llClockStartOffset PRESENTATION_CURRENT_POSITION), часы представления отправляют уведомление IMFClockStateSink::OnClockRestart . В противном случае часы отправляют уведомление IMFClockStateSink::OnClockStart .
Часы презентации инициируют изменение состояния, вызывая OnClockStart или OnClockRestart в источнике времени часов. Этот вызов выполняется синхронно. Если не удается, изменение состояния не происходит. Если вызов выполнен успешно, состояние изменяется, а часы уведомляют других подписчиков об изменении состояния, вызывая их методы OnClockStart или OnClockRestart . Эти вызовы выполняются асинхронно.
Если часы уже запущены, при повторном вызове start происходит поиск часов в новую позицию StartOffset .
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [классические приложения | Приложения UWP] |
Минимальная версия сервера | Windows Server 2008 [классические приложения | Приложения UWP] |
Целевая платформа | Windows |
Header | mfidl.h |
Библиотека | Mfuuid.lib |