Partager via

GetSystemCpuSetInformation, fonction (processthreadsapi.h)

  • Article

Permet à une application d’interroger les ensembles de processeurs disponibles sur le système et leur état actuel.

Syntaxe

BOOL GetSystemCpuSetInformation(
  PSYSTEM_CPU_SET_INFORMATION Information,
  ULONG                       BufferLength,
  PULONG                      ReturnedLength,
  HANDLE                      Process,
  ULONG                       Flags
);

Paramètres

Information

Pointeur vers une structure de SYSTEM_CPU_SET_INFORMATION qui reçoit les données du jeu de processeurs. Passez la valeur NULL avec une longueur de mémoire tampon de 0 pour déterminer la taille de mémoire tampon requise.

BufferLength

Longueur, en octets, de la mémoire tampon de sortie passée en tant qu’argument Information.

ReturnedLength

Longueur, en octets, des données valides dans la mémoire tampon de sortie si la mémoire tampon est suffisamment grande, ou la taille requise de la mémoire tampon de sortie. S’il n’existe aucun ensemble de processeurs, cette valeur sera 0.

Process

Handle facultatif à un processus. Ce processus est utilisé pour déterminer la valeur de l’indicateur AllocationToTargetProcess dans la structure SYSTEM_CPU_SET_INFORMATION. Si un jeu de processeurs est alloué au processus spécifié, l’indicateur est défini. Sinon, c’est clair. Ce handle doit avoir le droit d’accès PROCESS_QUERY_LIMITED_INFORMATION. La valeur retournée par GetCurrentProcess peut également être spécifiée ici.

Flags

Réservé, doit être 0.

Valeur retournée

Si l’API réussit, elle retourne TRUE. En cas d’échec, la raison de l’erreur est disponible via GetLastError. Si la mémoire tampon d’informations était NULL ou n’était pas assez grande, le code d’erreur ERROR_INSUFFICIENT_BUFFER est retourné. Cette API ne peut pas échouer en cas de transmission de paramètres valides et d’une mémoire tampon suffisamment grande pour contenir toutes les données renvoyées.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
Serveur minimal pris en charge WIndows Server 2016
En-tête processthreadsapi.h