Partager via


QueryPerformanceCounter, fonction (profileapi.h)

Récupère la valeur actuelle du compteur de performances, qui est un horodatage à haute résolution (<1us) qui peut être utilisé pour les mesures d’intervalle de temps.

Syntaxe

BOOL QueryPerformanceCounter(
  [out] LARGE_INTEGER *lpPerformanceCount
);

Paramètres

[out] lpPerformanceCount

Pointeur vers une variable qui reçoit la valeur actuelle du compteur de performances, en nombres.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError. Sur les systèmes qui exécutent Windows XP ou version ultérieure, la fonction réussit toujours quand des paramètres valides sont donnés et ne retournent donc jamais zéro.

Remarques

Pour plus d’informations sur cette fonction et son utilisation, consultez Acquisition d’horodatages haute résolution.

Examples

// 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;
}

Spécifications

Requirement Valeur
Client minimum requis Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
plateforme cible Fenêtres
Header profileapi.h (inclure Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

Voir aussi

Acquisition d’horodatages haute résolution

conceptuelle

GetSystemTimePreciseAsFileTime

KeQueryPerformanceCounter

QueryPerformanceFrequency

Référence

Heure

Minuteries