GetProcessorSystemCycleTime, fonction (sysinfoapi.h)

  • Article

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

Voir aussi

Groupes de processeurs