Функция 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 |