Função QueryUnbiasedInterruptTimePrecise (realtimeapiset.h)

Artigo
03/08/2023

Obtém a contagem de tempo de interrupção imparcial atual, em uma forma mais precisa do que QueryUnbiasedInterruptTime . A contagem de tempo de interrupção imparcial não inclui o tempo gasto pelo sistema em suspensão ou hibernação.

Sintaxe

void QueryUnbiasedInterruptTimePrecise(
  [out] PULONGLONG lpUnbiasedInterruptTimePrecise
);

Parâmetros

[out] lpUnbiasedInterruptTimePrecise

Um ponteiro para um ULONGLONG no qual receber a contagem de tempo de interrupção imparcial em unidades de tempo do sistema de 100 nanossegundos. Divida por dez milhões, ou 1e7, para obter segundos (há 1e9 nanossegundos em um segundo, então há 1e7 100 nanossegundos em um segundo).

Retornar valor

Nenhum

Comentários

QueryUnbiasedInterruptTimePrecise é semelhante à rotina QueryUnbiasedInterruptTime , mas é mais precisa. O tempo de interrupção relatado por QueryUnbiasedInterruptTime baseia-se no tique mais recente do temporizador do relógio do sistema. O temporizador do relógio do sistema é o temporizador de hardware que gera periodicamente interrupções para o relógio do sistema. O período uniforme entre interrupções do temporizador do relógio do sistema é conhecido como um tique de relógio do sistema e normalmente está no intervalo de 0,5 milissegundos a 15.625 milissegundos, dependendo da plataforma de hardware. O valor de tempo de interrupção recuperado por QueryUnbiasedInterruptTime é preciso dentro de um tique de relógio do sistema.

Para fornecer um valor de tempo do sistema mais preciso do que o de QueryUnbiasedInterruptTime, QueryUnbiasedInterruptTimePrecise lê o hardware do temporizador diretamente, portanto, uma chamada QueryUnbiasedInterruptTimePrecise pode ser mais lenta do que uma chamada QueryUnbiasedInterruptTime .

Chame a rotina KeQueryTimeIncrement para determinar a duração de um tique de relógio do sistema.

Consulte também Comentários em QueryUnbiasedInterruptTime.

Nota A função QueryUnbiasedInterruptTimePrecise produz resultados diferentes em builds de depuração ("verificados") do Windows, pois a contagem de tempo de interrupção e a contagem de tiques são avançadas em aproximadamente 49 dias. Isso ajuda a identificar bugs que podem não ocorrer até que o sistema esteja em execução há muito tempo. O build verificado está disponível para assinantes do MSDN por meio do site do MSDN (Microsoft Developer Network ).

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0601 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2016 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	realtimeapiset.h
Biblioteca	Kernel32.lib
DLL	Kernel32.dll