Función QueryInterruptTime (realtimeapiset.h)

Obtiene el recuento actual de tiempo de interrupción. Para obtener un recuento más preciso, use QueryInterruptTimePrecise.

Sintaxis

void QueryInterruptTime(
  [out] PULONGLONG lpInterruptTime
);

Parámetros

[out] lpInterruptTime

Puntero a un ULONGLONG en el que recibir el recuento de tiempo de interrupción en unidades de tiempo del sistema de 100 nanosegundos. Divida entre diez millones o 1e7 para obtener segundos (hay 1e9 nanosegundos en un segundo, por lo que hay 1e7 100 nanosegundos en un segundo).

Valor devuelto

Ninguno

Observaciones

El recuento de tiempo de interrupción comienza en cero cuando el sistema se inicia y se incrementa en cada interrupción del reloj por la longitud de un tic de reloj. La longitud exacta de un tic de reloj depende del hardware subyacente y puede variar entre sistemas.

A diferencia de la hora del sistema, el recuento de tiempo de interrupción no está sujeto a ajustes por parte de los usuarios o el servicio de hora de Windows. Las aplicaciones pueden usar el recuento de tiempo de interrupción para medir las duraciones más finas de las que son posibles con la hora del sistema. Las aplicaciones que requieren mayor precisión que el recuento de tiempo de interrupción deben usar un temporizador de alta resolución . Use la función queryPerformanceFrequency para recuperar la frecuencia del temporizador de alta resolución y la función QueryPerformanceCounter para recuperar el valor del contador.

La resolución del temporizador establecida por las funciones timeBeginPeriod y timeEndPeriod afecta a la resolución de la función queryInterruptTime de . Sin embargo, no se recomienda aumentar la resolución del temporizador porque puede reducir el rendimiento general del sistema y aumentar el consumo de energía del sistema evitando que el procesador entre en estados de ahorro de energía. En su lugar, las aplicaciones deben usar un temporizador de alta resolución.

Nota La función QueryInterruptTime genera resultados diferentes en las compilaciones de depuración ("checked") de Windows, ya que el recuento de tiempo de interrupción y el recuento de tics están avanzados aproximadamente 49 días. Esto ayuda a identificar errores que podrían no producirse hasta que el sistema se haya estado ejecutando durante mucho tiempo.

 

Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0601 o posterior. Para obtener más información, vea Using the Windows Headers.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10 [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2016 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	realtimeapiset.h
biblioteca de	Mincore.lib
DLL de	Kernel32.dll

Consulte también

tiempo de interrupción

QueryInterruptTimePrecise

QueryUnbiasedInterruptTime

QueryUnbiasedInterruptTimePreci se

System Power States

de hora de Windows