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 |