Función PcGetTimeInterval (portcls.h)

La función PcGetTimeInterval devuelve el tiempo transcurrido desde una hora especificada. El tiempo se mide en unidades de 100 nanosegundos.

Sintaxis

PORTCLASSAPI ULONGLONG PcGetTimeInterval(
  [in] ULONGLONG Since
);

Parámetros

[in] Since

Especifica el tiempo desde el que se va a medir el intervalo. Normalmente, se llama a esta función una vez con un valor "since" de cero para obtener la hora actual y se llama posteriormente con un elemento "since" de la hora actual registrada para obtener intervalos de tiempo desde ese momento.

Valor devuelto

PcGetTimeInterval devuelve la hora actual menos Since.

Comentarios

Valor especificado en el parámetro Since se mide en unidades de 100 nanosegundos. Si Since es cero, el tiempo devuelto es el número de tics de 100 nanosegundos desde el 1 de enero de 1601. Las unidades de tiempo son las mismas que las usadas para especificar la hora del sistema en la función KeQuerySystemTime .

Las macros siguientes de portcls.h son útiles para convertir segundos, milisegundos y microsegundos en unidades de 100 milisegundos:

GTI_SECONDS

GTI_MILLISECONDS

GTI_MICROSECONDS

Esta función se puede usar con fines de tiempo guardando primero la hora actual,

  ULONGLONG ullTime = PcGetTimeInterval(0);

y, a continuación, comprueba si se ha superado el intervalo necesario.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	El controlador del sistema PortCls implementa la función PcGetTimeInterval en Microsoft Windows 98/Me y en los sistemas operativos Windows 2000 y versiones posteriores.
Plataforma de destino	Universal
Encabezado	portcls.h (incluir Portcls.h)
Library	Portcls.lib
IRQL	Cualquier nivel

Consulte también

KeQuerySystemTime