Função QueryPerformanceFrequency (profileapi.h)

Artigo
03/01/2024

Recupera a frequência do contador de desempenho. A frequência do contador de desempenho é corrigida na inicialização do sistema e é consistente em todos os processadores. Portanto, a frequência só precisa ser consultada após a inicialização do aplicativo e o resultado pode ser armazenado em cache.

Sintaxe

BOOL QueryPerformanceFrequency(
  [out] LARGE_INTEGER *lpFrequency
);

Parâmetros

[out] lpFrequency

Um ponteiro para uma variável que recebe a frequência atual do contador de desempenho, em contagens por segundo. Se o hardware instalado não der suporte a um contador de desempenho de alta resolução, esse parâmetro poderá ser zero (isso não ocorrerá em sistemas que executam o Windows XP ou posterior).

Retornar valor

Se o hardware instalado der suporte a um contador de desempenho de alta resolução, o valor retornado não será zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. Em sistemas que executam o Windows XP ou posterior, a função sempre terá êxito e, portanto, nunca retornará zero.

Comentários

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
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	profileapi.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll