QueryIdleProcessorCycleTimeEx, fonction (realtimeapiset.h)
Récupère le temps de cycle cumulé pour le thread inactif sur chaque processeur logique du groupe de processeurs spécifié.
Syntaxe
BOOL QueryIdleProcessorCycleTimeEx(
[in] USHORT Group,
[in, out] PULONG BufferLength,
[out] PULONG64 ProcessorIdleCycleTime
);
Paramètres
[in] Group
Nombre du groupe de processeurs pour lequel récupérer le temps de cycle.
[in, out] BufferLength
Lors de l’entrée, spécifie la taille de la mémoire tampon ProcessorIdleCycleTime, en octets. Cette mémoire tampon devrait être de 8 fois le nombre de processeurs dans le groupe.
En sortie, spécifie le nombre d’éléments écrits dans la mémoire tampon. Si la taille de la mémoire tampon n’est pas suffisante, la fonction échoue et ce paramètre reçoit la longueur requise de la mémoire tampon.
[out] ProcessorIdleCycleTime
Nombre de cycles d’horloge du processeur utilisés par chaque thread inactif. Si ce paramètre est NULL, la fonction met à jour la BufferLength paramètre avec la longueur requise.
Valeur de retour
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, utilisez GetLastError.
Remarques
Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT >= 0x0601. Pour plus d’informations, consultez Utilisation des en-têtes Windows.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 7 [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | realtimeapiset.h (include Windows.h) |
| bibliothèque | Mincore.lib |
| DLL | Kernel32.dll |