Função KeQueryPerformanceCounter (wdm.h)

Artigo
03/01/2024

A rotina KeQueryPerformanceCounter recupera o valor atual e a frequência do contador de desempenho.

Use KeQueryPerformanceCounter para adquirir carimbos de data/hora de alta resolução (<1μs) para medidas de intervalo de tempo.

Sintaxe

NTHALAPI LARGE_INTEGER KeQueryPerformanceCounter(
  [out, optional] PLARGE_INTEGER PerformanceFrequency
);

Parâmetros

[out, optional] PerformanceFrequency

Um ponteiro para uma variável na qual KeQueryPerformanceCounter grava a frequência do contador de desempenho, em tiques por segundo. Esse parâmetro é opcional e pode ser NULL se o chamador não precisar do valor de frequência do contador.

Retornar valor

KeQueryPerformanceCounter retorna o valor do contador de desempenho em unidades de tiques.

Comentários

KeQueryPerformanceCounter retorna um inteiro de 64 bits que representa o valor atual de um contador monotonicamente não indexador de alta resolução.

Para obter a frequência do contador de desempenho, especifique um valor de ponteiro não NULL para o parâmetro PerformanceFrequency . A frequência do contador de desempenho é corrigida na inicialização do sistema e é consistente em todos os processadores. Portanto, um driver pode armazenar em cache a frequência do contador de desempenho durante a inicialização.

Para obter mais informações sobre essa função e seu uso, consulte Adquirindo carimbos de data/hora de alta resolução.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 2000.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	Hal.lib
DLL	Hal.dll
IRQL	Qualquer nível