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 do sistema correlacionada.
Sintaxe
LONGLONG GetCorrelatedTime(
[out] PLONGLONG SystemTime
);
Parâmetros
[out] SystemTime
Um ponteiro para uma variável do tipo LONGLONG que recebe o tempo atual do sistema em 100 unidades nanossegundos.
Valor de retorno
O método IKsReferenceClock::GetCorrelatedTime retorna o tempo de fluxo, especificado por padrão em unidades de 100 nanossegundos. O tempo do sistema correlacionado é retornado em SystemTime.
Observações
Use esse método para determinar a diferença entre o tempo de fluxo e o tempo do sistema. IKsReferenceClock::GetCorrelatedTime retorna os horários que os dois relógios mostram ao mesmo tempo.
Para obter os resultados mais precisos, chame esse método somente quando o fluxo estiver em um estado em 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 AVStream Clocks.
O AVStream usa a propriedade KSPROPERTY_CLOCK_CORRELATEDTIME para recuperar o tempo correlacionado.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |