Интерфейс IKsReferenceClock (ks.h)

Статья
02/29/2024

Интерфейс IKsReferenceClock — это интерфейс в стиле COM, предоставляемый AVStream на всех контактах. Закрепление передает запрос на часы master.

Наследование

Интерфейс IKsReferenceClock наследуется от интерфейса IUnknown .

Методы

Интерфейс IKsReferenceClock имеет следующие методы.


IKsReferenceClock::GetCorrelatedPhysicalTime Метод IKsReferenceClock::GetCorrelatedPhysicalTime запрашивает связанные эталонные часы для текущего физического времени и извлекает связанное системное время.
IKsReferenceClock::GetCorrelatedTime Метод IKsReferenceClock::GetCorrelatedTime запрашивает связанные ссылочные часы для текущего времени потока и получает коррелированное системное время.
IKsReferenceClock::GetPhysicalTime Метод IKsReferenceClock::GetPhysicalTime запрашивает связанные эталонные часы для текущего физического времени.
IKsReferenceClock::GetResolution Метод IKsReferenceClock::GetResolution запрашивает соответствующие ссылочные часы для их разрешения.
IKsReferenceClock::GetState Метод IKsReferenceClock::GetState запрашивает у связанных ссылочных часов текущее состояние потоковой передачи.
IKsReferenceClock::GetTime Метод IKsReferenceClock::GetTime запрашивает связанные ссылочные часы для текущего времени.

Мини-диск может получить интерфейс IKsReferenceClock , вызвав KsPinGetReferenceClockInterface. Так как это интерфейс в стиле COM, KsPinGetReferenceClockInterface вызывает QueryInterface, который, в свою очередь, вызывает AddRef для увеличения указателя интерфейса. Это означает, что после завершения работы с интерфейсом IKsReferenceClock мини-диск должен освободить его, вызвав Release.

Клиенты, написанные на языке C, будут видеть интерфейс IKsReferenceClock как структуру, содержащую указатель на таблицу функций вместо абстрактного базового класса C++. Клиент, написанный на C++, может выполнять следующие действия:

PIKSREFERENCECLOCK RefClock;

if (NT_SUCCESS (
  KsPinGetReferenceClockInterface (
    Pin,
    &RefClock)
) {
    ... RefClock -> GetCorrelatedTime (...);
    RefClock -> Release ();
}

Однако клиент, написанный на языке C, будет выполнять следующие действия:

PIKSREFERENCECLOCK RefClock;

If (NT_SUCCESS (
  KsPinGetReferenceClockInterface (
    Pin,
    &RefClock)
) {
  ... RefClock -> lpVtbl -> GetCorrelatedTime (...);
  RefClock -> lpVtbl -> Release ();
}

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