Função KeQueryPerformanceCounter (WDM. 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 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 na qual KeQueryPerformanceCounter grava a frequência do contador de desempenho, em tiques por segundo. Esse parâmetro é opcional e pode ser nulo se o chamador não precisar do valor de frequência do contador.

Valor retornado

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 de nondecreasing monotônico de alta resolução.

Para obter a frequência do contador de desempenho, especifique um valor de ponteiro não nulo para o parâmetro PerformanceFrequency . A frequência do contador de desempenho é fixa 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

   
Cliente mínimo com suporte disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho WDM. h (incluir WDM. h, Ntddk. h, Ntifs. h)
Biblioteca Hal. lib
DLL Hal.dll
IRQL Qualquer nível

Confira também

KeQueryInterruptTime

KeQuerySystemTime

KeQueryTickCount

KeQueryTimeIncrement

QueryPerformanceCounter

QueryPerformanceFrequency