Función QueryInterruptTimePrecise (realtimeapiset.h)

Artículo
07/16/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

Ninguno

Observaciones

QueryInterruptTimePrecise es similar a la rutina de QueryInterruptTime, pero es más precisa. El tiempo de interrupción notificado por QueryInterruptTime se basa en el tic más reciente 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 de reloj del sistema se conoce como tic de reloj del sistema y normalmente se encuentra 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 comentarios en QueryInterruptTime.

Nota Las compilaciones QueryInterruptTimePrecise generan resultados diferentes en las compilaciones de depuración ("comprobado") 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