Função KeQueryPerformanceCounter (ntifs.h)

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 Windows 2000
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclui Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca Hal.lib
DLL Hal.dll
IRQL Qualquer nível

Confira também

KeQueryInterruptTime

KeQueryTickCount

KeQueryTimeIncrement

QueryPerformanceCounter

QueryPerformanceFrequency