Compartilhar via


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

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

Confira também

Aquisição de carimbos de data/hora de alta resolução

Conceitual

GetSystemTimePreciseAsFileTime

KeQueryPerformanceCounter

QueryPerformanceCounter

Referência

Hora

Temporizadores