Função KeQueryPerformanceCounter (ntifs.h)
A rotina KeQueryPerformanceCounter recupera o valor e a frequência atuais do contador de desempenho.
Use KeQueryPerformanceCounter para adquirir carimbos de data/hora de alta resolução (<1μs) para medições 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 à 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.
Valor de retorno
KeQueryPerformanceCounter retorna o valor do contador de desempenho em unidades de tiques.
Observações
KeQueryPerformanceCounter retorna um inteiro de 64 bits que representa o valor atual de um contador monotonicamente não descritivo de alta resolução.
Para obter a frequência do contador de desempenho, especifique um valor de ponteiroNULL não 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 Adquirir carimbos de data/hora de alta resolução.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 |
| da Plataforma de Destino | Universal |
| cabeçalho | ntifs.h (incluem Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | Hal.lib |
| de DLL | Hal.dll |
| IRQL | Qualquer nível |