Función QueryPerformanceFrequency (profileapi.h)

Artículo
03/05/2024

Recupera la frecuencia del contador de rendimiento. La frecuencia del contador de rendimiento se fija en el arranque del sistema y es coherente en todos los procesadores. Por lo tanto, la frecuencia solo debe consultarse tras la inicialización de la aplicación y el resultado se puede almacenar en caché.

Sintaxis

BOOL QueryPerformanceFrequency(
  [out] LARGE_INTEGER *lpFrequency
);

Parámetros

[out] lpFrequency

Puntero a una variable que recibe la frecuencia del contador de rendimiento actual, en recuentos por segundo. Si el hardware instalado no admite un contador de rendimiento de alta resolución, este parámetro puede ser cero (esto no se producirá en sistemas que ejecutan Windows XP o posterior).

Valor devuelto

Si el hardware instalado admite un contador de rendimiento de alta resolución, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError. En los sistemas que ejecutan Windows XP o posterior, la función siempre se realizará correctamente y, por tanto, nunca devolverá cero.

Comentarios

Para obtener más información sobre esta función y su uso, consulte Adquisición de marcas de tiempo de alta resolución.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	profileapi.h (incluir Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll