Función QueryInterruptTime (realtimeapiset.h)

Artículo
03/01/2024

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

None

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 los 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 . 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 compilaciones de depuración ("activadas") 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. La compilación activada está disponible para los suscriptores de MSDN a través del sitio web de Microsoft Developer Network (MSDN).

Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0601 o posterior. Para obtener más información, vea Uso de los encabezados de Windows.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10 [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2016 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	realtimeapiset.h
Library	Mincore.lib
Archivo DLL	Kernel32.dll