Метод IMFPresentationClock::Start (mfidl.h)

  • Статья

Запускает часы презентации.

Синтаксис

HRESULT Start(
  [in] LONGLONG llClockStartOffset
);

Параметры

[in] llClockStartOffset

Начальное время начала в 100-наносекундных единицах. Во время вызова метода Start метод IMFPresentationClock::GetTime возвращает это значение, а оттуда увеличивается время часов. Если значение равно PRESENTATION_CURRENT_POSITION, часы начинаются с текущей позиции. Используйте это значение, если часы приостановлены и вы хотите перезапустить их из той же позиции.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_CLOCK_NO_TIME_SOURCE
 Для этих часов не задан источник времени.

Комментарии

Этот метод допустим во всех состояниях (остановлен, приостановлен или запущен).

Если часы приостановлены и перезапущены из той же позиции (значение 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

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

IMFPresentationClock

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