Função QueryPerformanceFrequency (profileapi.h)

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).

Valor de retorno

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 quando determinados parâmetros válidos e, portanto, nunca retornará zero.

Observações

Para obter mais informações sobre essa função e seu uso, consulte Como adquirir carimbos de data/hora de alta resolução.

Requirements

Requirement	Value
Cliente mínimo suportado	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo compatível	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
Header	profileapi.h (inclua Windows.h)
Library	Kernel32.lib
de DLL	Kernel32.dll