GetProcessorSystemCycleTime, fonction (sysinfoapi.h)
Récupère le temps de cycle que chaque processeur du groupe de processeurs spécifié a passé à exécuter des appels de procédure différée (DPC) et des routines de service d’interruption (ISR) depuis que le processeur est devenu actif.
Syntaxe
BOOL GetProcessorSystemCycleTime(
[in] USHORT Group,
[out] PSYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION Buffer,
[in, out] PDWORD ReturnedLength
);
Paramètres
[in] Group
Numéro du groupe de processeurs pour lequel récupérer le temps de cycle.
[out] Buffer
Pointeur vers une mémoire tampon pour recevoir une structure SYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION pour chaque processeur du groupe. À la sortie, le membre DWORD64 CycleTime de cette structure est défini sur la durée de cycle d’un processeur.
[in, out] ReturnedLength
Taille de la mémoire tampon, en octets. Lorsque la fonction retourne, ce paramètre contient le nombre d’octets écrits dans Buffer. Si la mémoire tampon est trop petite pour les données, la fonction échoue avec ERROR_INSUFFICIENT_BUFFER et définit le paramètre ReturnedLength sur la taille de mémoire tampon requise.
Valeur retournée
Si la fonction réussit, la valeur de retour est une valeur 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.
Si la valeur d’erreur est ERROR_INSUFFICIENT_BUFFER, le paramètre ReturnedLength contient la taille de mémoire tampon requise.
Remarques
Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0601 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | sysinfoapi.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |