Функция KsPinGetReferenceClockInterface (ks.h)

Функция KsPinGetReferenceClockInterface возвращает интерфейс стиля COM для ссылочных часов, связанных с pin. Этот указатель интерфейса будет интерфейсом IKsReferenceClock .

Синтаксис

KSDDKAPI NTSTATUS KsPinGetReferenceClockInterface(
  [in]  PKSPIN             Pin,
  [out] PIKSREFERENCECLOCK *Interface
);

Параметры

[in] Pin

Указатель на структуру KSPIN , для которой возвращается интерфейс ссылочных часов.

[out] Interface

Указатель на расположение памяти, которое получает адрес интерфейса IKsReferenceClock . Это интерфейс в стиле COM со связанным числом ссылок. Мини-драйверы должны освободить интерфейс по завершении работы с ним.

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

KsPinGetReferenceClockInterface возвращает STATUS_SUCCESS и помещает адрес интерфейса IKsReferenceClock в интерфейс, если контакт реализует часы или получил уведомление о master часов через свойство KSPROPERTY_STREAM_MASTERCLOCK. Возвращает STATUS_DEVICE_NOT_READY, если пин-код еще не получил уведомление о master часах.

Комментарии

Чаще всего вызов KsPinGetReferenceClockInterface происходит при переходе состояния на KSSTATE_ACQUIRE.

Дополнительные сведения об использовании интерфейса IKsReferenceClock, возвращаемого этой подпрограммой, см. в разделе Часы AVStream.

Требования

Требование Значение
Минимальная версия клиента Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версий.
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)
Библиотека Ks.lib
IRQL PASSIVE_LEVEL

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

IKsControl

IKsReferenceClock

KsFilterGetOuterUnknown

KsGetOuterUnknown

KsPinGetConnectedFilterInterface

KsPinGetConnectedPinInterface

KsPinSetPinClockTime

KsRegisterAggregatedClientUnknown