Función QueryPerformanceCounter (profileapi.h)

Artículo
03/05/2024

Recupera el valor actual del contador de rendimiento, que es una marca de tiempo de alta resolución (<1us) que se puede usar para las mediciones de intervalo de tiempo.

Sintaxis

BOOL QueryPerformanceCounter(
  [out] LARGE_INTEGER *lpPerformanceCount
);

Parámetros

[out] lpPerformanceCount

Puntero a una variable que recibe el valor actual del contador de rendimiento, en recuentos.

Valor devuelto

Si la función se realiza correctamente, 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 versiones posteriores, 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.

Ejemplos

// Gets the current number of ticks from QueryPerformanceCounter. Throws an
// exception if the call to QueryPerformanceCounter fails.
static inline int64_t GetTicks()
{
    LARGE_INTEGER ticks;
    if (!QueryPerformanceCounter(&ticks))
    {
        winrt::throw_last_error();
    }
    return ticks.QuadPart;
}

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