Función KsPinGetReferenceClockInterface (ks.h)

Artículo
02/26/2024

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