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 |