Método IKsReferenceClock::GetCorrelatedTime (ks.h)

El método IKsReferenceClock::GetCorrelatedTime consulta el reloj de referencia asociado para la hora de la secuencia actual y adquiere la hora del sistema correlacionada.

Sintaxis

LONGLONG GetCorrelatedTime(
  [out] PLONGLONG SystemTime
);

Parámetros

[out] SystemTime

Puntero a una variable con tipo LONGLONG que recibe la hora actual del sistema en 100 unidades nanosegundas.

Valor devuelto

El método IKsReferenceClock::GetCorrelatedTime devuelve el tiempo de secuencia, especificado de forma predeterminada en unidades de 100 nanosegundos. La hora del sistema correlacionada se devuelve en SystemTime.

Comentarios

Use este método para determinar la diferencia entre el tiempo de flujo y la hora del sistema. IKsReferenceClock::GetCorrelatedTime devuelve las horas que ambos relojes muestran en el mismo momento.

Para obtener los resultados más precisos, llame a este método solo cuando la secuencia se encuentra en un estado en ejecución (KSSTATE_RUN) y no durante una transición de estado.

Debe usar este método al obtener una marca de tiempo para colocar en el miembro PresentationTime de KSSTREAM_HEADER.

Para obtener más información, vea AvStream Clocks.

AVStream usa la propiedad KSPROPERTY_CLOCK_CORRELATEDTIME para recuperar el tiempo correlacionado.

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado ks.h (incluye Ks.h)

Consulte también

KsPinGetReferenceClockInterface