QueryIdleProcessorCycleTime, fonction (realtimeapiset.h)
Récupère le temps de cycle pour le thread inactif de chaque processeur dans le système.
Sur un système avec plus de 64 processeurs, cette fonction récupère le temps de cycle pour le thread inactif de chaque processeur du groupe de processeurs auquel le thread appelant est affecté. Utilisez la fonction QueryIdleProcessorCycleTimeEx pour récupérer l’heure de cycle du thread inactif sur chaque processeur logique pour un groupe de processeurs spécifique.
Syntaxe
BOOL QueryIdleProcessorCycleTime(
[in, out] PULONG BufferLength,
[out] PULONG64 ProcessorIdleCycleTime
);
Paramètres
[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. Cette mémoire tampon doit être 8 fois le nombre de processeurs dans la taille du système.
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, appelez GetLastError.
Remarques
Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT en tant que 0x0600 ou version ultérieure.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | realtimeapiset.h (inclure Windows.h sur Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| bibliothèque | Mincore.lib |
| DLL | Kernel32.dll |