Метод IMFPresentationTimeSource::GetUnderlyingClock (mfidl.h)

Извлекает базовые часы, которые источник времени презентации использует для создания часов.

Синтаксис

HRESULT GetUnderlyingClock(
  [out] IMFClock **ppClock
);

Параметры

[out] ppClock

Получает указатель на интерфейс IMFClock часов. Вызывающий объект должен освободить интерфейс .

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

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

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

Комментарии

Источник времени презентации должен поддерживать остановку, запуск, приостановку и изменение скорости. Однако во многих случаях источник времени получает свое время от аппаратных часов или другого устройства. Базовые часы всегда работают и могут не поддерживать изменения скорости.

При необходимости источник времени может предоставить базовые часы, реализовав этот метод. Базовые часы всегда работают, даже если источник времени презентации приостановлен или остановлен. (Таким образом, базовые часы возвращают флаг MFCLOCK_CHARACTERISTICS_FLAG_ALWAYS_RUNNING в методе IMFClock::GetClockCharacteristics .

Базовые часы полезны, если вы хотите принимать решения на основе часов, пока часы презентации остановлены или приостановлены.

Если источник времени не предоставляет базовые часы, метод возвращает MF_E_NO_CLOCK.

Требования

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

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

IMFPresentationTimeSource

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