Partilhar via


Função PcGetTimeInterval (portcls.h)

A função PcGetTimeInterval retorna o tempo decorrido desde um horário especificado. 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" do tempo atual registrado para obter intervalos de tempo a partir desse tempo.

Valor de retorno

PcGetTimeInterval retorna o tempo atual menos Desde.

Observações

O valor especificado no parâmetro uma vez que é medido em unidades de 100 nanossegundos. Se Como é zero, o tempo retornado é 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 o tempo 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 o tempo atual,

  ULONGLONG ullTime = PcGetTimeInterval(0);

e verificando se o intervalo necessário passou

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

Requisitos

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

Consulte também

KeQuerySystemTime