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

O método IKsReferenceClock::GetCorrelatedTime consulta o relógio de referência associado para o tempo de fluxo atual e adquire a hora correlacionada do sistema.

Sintaxe

LONGLONG GetCorrelatedTime(
  [out] PLONGLONG SystemTime
);

Parâmetros

[out] SystemTime

Um ponteiro para uma variável do tipo LONGLONG que recebe a hora atual do sistema em 100 unidades de nanossegundos.

Retornar valor

O método IKsReferenceClock::GetCorrelatedTime retorna o tempo de fluxo, especificado por padrão em unidades de 100 nanossegundos. A hora correlacionada do sistema é retornada em SystemTime.

Comentários

Use esse método para determinar a diferença entre o tempo de fluxo e a hora do sistema. IKsReferenceClock::GetCorrelatedTime retorna os horários que os dois relógios mostram no mesmo momento.

Para obter os resultados mais precisos, chame esse método somente quando o fluxo estiver em um estado de execução (KSSTATE_RUN) e não durante uma transição de estado.

Você deve usar esse método ao obter um carimbo de data/hora para colocar no membro PresentationTime do KSSTREAM_HEADER.

Para obter mais informações, consulte Relógios AVStream.

O AVStream usa a propriedade KSPROPERTY_CLOCK_CORRELATEDTIME para recuperar o tempo correlacionado.

Requisitos

Confira também

KsPinGetReferenceClockInterface