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 KSPIN para la que se va a devolver la interfaz de reloj de referencia.
[out] Interface
Puntero a una ubicación de memoria que recibe la dirección de una interfaz IKsReferenceClock . Se trata de una interfaz de estilo COM con un recuento de referencias asociado. Los minidrivers deben liberar la interfaz cuando termine con ella.
Valor devuelto
KsPinGetReferenceClockInterface devuelve STATUS_SUCCESS y deposita la dirección de la interfaz IKsReferenceClock 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.
Comentarios
El tiempo más común para llamar a KsPinGetReferenceClockInterface es 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 | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX. |
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluya Ks.h) |
| Library | Ks.lib |
| IRQL | PASSIVE_LEVEL |