Função PcGetTimeInterval (portcls.h)

A função PcGetTimeInterval retorna o tempo decorrido desde uma hora especificada. O tempo é medido em unidades de 100 nanossegundos.

Sintaxe

PORTCLASSAPI ULONGLONG PcGetTimeInterval(
  [in] ULONGLONG Since
);

Parâmetros

[in] Since

Especifica o tempo do qual medir o intervalo. Normalmente, essa função é chamada uma vez com um "since" de zero para obter a hora atual e é chamada posteriormente com um "since" da hora atual registrada para obter intervalos de tempo a partir desse momento.

Retornar valor

PcGetTimeInterval retorna a hora atual menos Since.

Comentários

O valor especificado no parâmetro Since é medido em unidades de 100 nanossegundos. Se Since for zero, o tempo retornado será o número de tiques de 100 nanossegundos desde 1º de janeiro de 1601. As unidades de tempo são as mesmas usadas para especificar a hora do sistema na função KeQuerySystemTime .

As macros a seguir de portcls.h são úteis para converter segundos, milissegundos e microssegundos em unidades de 100 milissegundos:

GTI_SECONDS

GTI_MILLISECONDS

GTI_MICROSECONDS

Essa função pode ser usada para fins de tempo, salvando primeiro a hora atual,

  ULONGLONG ullTime = PcGetTimeInterval(0);

e, em seguida, verificando se o intervalo necessário passou

  if (PcGetTimeInterval(ullTime) >= GTI_MILLISECONDS(5))

Requisitos

Requisito	Valor
Cliente mínimo com suporte	O driver do sistema PortCls implementa a função PcGetTimeInterval no Microsoft Windows 98/Me e no Windows 2000 e em sistemas operacionais posteriores.
Plataforma de Destino	Universal
Cabeçalho	portcls.h (inclua Portcls.h)
Biblioteca	Portcls.lib
IRQL	Qualquer nível

Confira também

KeQuerySystemTime