GetSystemCpuSetInformation, fonction

Article
06/13/2023

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

Syntaxe

BOOL WINAPI GetSystemCpuSetInformation(
  _Out_opt_  PSYSTEM_CPU_SET_INFORMATION  Information,
  _In_       ULONG                        BufferLength,
  _Out_      PULONG                       ReturnedLength,
  _In_opt_   HANDLE                       Process,
  _Reserved_ ULONG                        Flags
);

Paramètres

Informations [out, facultatif]: 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 [in]: Longueur, en octets, de la mémoire tampon de sortie passée en tant qu’argument Information.
RetourLength [out]: 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.
Processus [in, facultatif]: 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.
Indicateurs: 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.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 10 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2016 [applications de bureau \| Applications UWP]
En-tête	Processthreadsapi.h
Bibliothèque	Windows.h
DLL	Kernel32.dll

Share via