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


Метод IKsReferenceClock::GetCorrelatedTime (ks.h)

Метод IKsReferenceClock::GetCorrelatedTime запрашивает связанные ссылочные часы для текущего времени потока и получает коррелированное системное время.

Синтаксис

LONGLONG GetCorrelatedTime(
  [out] PLONGLONG SystemTime
);

Параметры

[out] SystemTime

Указатель на переменную типа LONGLONG, которая получает текущее системное время в 100 единицах наносекунд.

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

Метод IKsReferenceClock::GetCorrelatedTime возвращает время потока, заданное по умолчанию в единицах 100 наносекунд. Связанное системное время возвращается в SystemTime.

Комментарии

Используйте этот метод для определения разницы между потоком времени и системным временем. IKsReferenceClock::GetCorrelatedTime возвращает время, показываемое обоими часами в один и тот же момент.

Для получения наиболее точных результатов вызывайте этот метод только в том случае, если поток находится в состоянии выполнения (KSSTATE_RUN), а не во время перехода состояния.

Этот метод следует использовать при получении метки времени для добавления в элемент PresentationTimeKSSTREAM_HEADER.

Дополнительные сведения см. в разделе Часы AVStream.

AVStream использует свойство KSPROPERTY_CLOCK_CORRELATEDTIME для получения коррелированного времени.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)

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

KsPinGetReferenceClockInterface