GetSystemCpuSetInformation, fonction
Permet à une application d’interroger les ensembles de processeurs disponibles sur le système et leur état actuel.
BOOL WINAPI GetSystemCpuSetInformation(
_Out_opt_ PSYSTEM_CPU_SET_INFORMATION Information,
_In_ ULONG BufferLength,
_Out_ PULONG ReturnedLength,
_In_opt_ HANDLE Process,
_Reserved_ ULONG Flags
);
-
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.
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.
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 |
|
Bibliothèque |
|
DLL |
|