Función QueryInterruptTimePrecise (realtimeapiset.h)

Artículo
03/05/2024

Obtiene el recuento de tiempo de interrupción actual, en un formato más preciso que QueryInterruptTime .

Sintaxis

void QueryInterruptTimePrecise(
  [out] PULONGLONG lpInterruptTimePrecise
);

Parámetros

[out] lpInterruptTimePrecise

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

QueryInterruptTimePrecise es similar a la rutina QueryInterruptTime , pero es más precisa. El tiempo de interrupción notificado por QueryInterruptTime se basa en el último tic del temporizador del reloj del sistema. El temporizador del reloj del sistema es el temporizador de hardware que genera periódicamente interrupciones para el reloj del sistema. El período uniforme entre las interrupciones del temporizador del reloj del sistema se conoce como un tic del reloj del sistema, y normalmente está en el intervalo de 0,5 milisegundos a 15,625 milisegundos, dependiendo de la plataforma de hardware. El valor de tiempo de interrupción recuperado por QueryInterruptTime es preciso dentro de un tic del reloj del sistema.

Para proporcionar un valor de hora del sistema más preciso que el de QueryInterruptTime, QueryInterruptTimePrecise lee directamente el hardware del temporizador, por lo que una llamada QueryInterruptTimePrecise puede ser más lenta que una llamada QueryInterruptTime .

Llame a la rutina KeQueryTimeIncrement para determinar la duración de un tic del reloj del sistema.

Vea también los comentarios en QueryInterruptTime.

Nota La función QueryInterruptTimePrecise genera resultados diferentes en las compilaciones de depuración ("checked") de Windows, ya que el recuento de tiempos 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 usa esta función, defina _WIN32_WINNT como 0x0601 o posterior. Para obtener más información, vea Usar 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