Compartir a través de


Función QueryPerformanceCounter (profileapi.h)

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

Vea también

Adquisición de marcas de tiempo de alta resolución

Conceptual

GetSystemTimePreciseAsFileTime

KeQueryPerformanceCounter

QueryPerformanceFrequency

Referencia

Time

Timers (Temporizadores)