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 |