Función QueryUnbiasedInterruptTimePrecise (realtimeapiset.h)

Artículo
09/26/2024

Obtiene el recuento de tiempo de interrupción no sesgado actual, en un formato más preciso que queryUnbiasedInterruptTime. El recuento de tiempo de interrupción no sesgado no incluye el tiempo que el sistema pasa en suspensión o hibernación.

Sintaxis

void QueryUnbiasedInterruptTimePrecise(
  [out] PULONGLONG lpUnbiasedInterruptTimePrecise
);

Parámetros

[out] lpUnbiasedInterruptTimePrecise

Puntero a un ULONGLONG en el que recibir el recuento de tiempo de interrupción no sesgado 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

QueryUnbiasedInterruptTimePrecise es similar a la rutina de QueryUnbiasedInterruptTime, pero es más precisa. El tiempo de interrupción notificado por QueryUnbiasedInterruptTime 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 QueryUnbiasedInterruptTime es preciso dentro de un tic del reloj del sistema.

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

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

Vea también comentarios en QueryUnbiasedInterruptTime.

Nota La función QueryUnbiasedInterruptTimePrecise 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 en 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