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
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |