Función KsPinGetReferenceClockInterface (ks.h)
La función KsPinGetReferenceClockInterface devuelve una interfaz de estilo COM al reloj de referencia asociado a Pin. Este puntero de interfaz será una interfaz IKsReferenceClock.
Sintaxis
KSDDKAPI NTSTATUS KsPinGetReferenceClockInterface(
[in] PKSPIN Pin,
[out] PIKSREFERENCECLOCK *Interface
);
Parámetros
[in] Pin
Puntero a la estructura de KSPIN para la que se devuelve la interfaz de reloj de referencia.
[out] Interface
Puntero a una ubicación de memoria que recibe la dirección de una interfaz de IKsReferenceClock. Se trata de una interfaz de estilo COM con un recuento de referencias asociado. Los minidrivers deben liberar la interfaz cuando termine con él.
Valor devuelto
KsPinGetReferenceClockInterface devuelve STATUS_SUCCESS y deposita la dirección del IKsReferenceClock interfaz en Interface si el pin implementa el reloj o ha recibido una notificación del reloj maestro a través de la propiedad KSPROPERTY_STREAM_MASTERCLOCK. Devuelve STATUS_DEVICE_NOT_READY si el pin aún no ha recibido la notificación del reloj maestro.
Observaciones
La hora más común de llamar a KsPinGetReferenceClockInterface está en una transición de estado a KSSTATE_ACQUIRE.
Consulte avStream Clocks para obtener más información sobre el uso de la interfaz IKsReferenceClock que devuelve esta rutina.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX. |
| de la plataforma de destino de | Universal |
| encabezado de | ks.h (incluya Ks.h) |
| biblioteca de | Ks.lib |
| irQL | PASSIVE_LEVEL |