GetProcessDefaultCpuSetMasks, fonction (processthreadsapi.h)

Article
08/25/2023

Récupère la liste des ensembles de processeurs dans le jeu de processus par défaut qui a été défini par SetProcessDefaultCpuSetMasks ou SetProcessDefaultCpuSets.

Syntaxe

BOOL GetProcessDefaultCpuSetMasks(
  HANDLE          Process,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

Paramètres

Process

Spécifie un handle de processus pour le processus à interroger. 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.

CpuSetMasks

Spécifie une mémoire tampon facultative pour récupérer une liste de structures GROUP_AFFINITY représentant les ensembles de processeurs par défaut du processus.

CpuSetMaskCount

Spécifie la taille du tableau CpuSetMasks , en éléments.

RequiredMaskCount

En cas de retour réussi, spécifie le nombre de structures d’affinité écrites dans le tableau. Si le tableau CpuSetMasks est trop petit, la fonction échoue avec ERROR_INSUFFICIENT_BUFFER et définit le paramètre RequiredMaskCount sur le nombre d’éléments requis. Le nombre d’éléments requis est toujours inférieur ou égal au nombre maximal de groupes retourné par GetMaximumProcessorGroupCount.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est zéro et les informations d’erreur étendues peuvent être récupérées en appelant GetLastError.

Si le tableau fourni est trop petit, la valeur d’erreur est ERROR_INSUFFICIENT_BUFFER et l’élément RequiredMaskCount est défini sur le nombre d’éléments requis.

Notes

Si aucun ensemble d’UC par défaut n’est défini pour un processus donné, le paramètre RequiredMaskCount est défini sur 0 et la fonction réussit.

Cette fonction est analogue à GetProcessDefaultCpuSets, sauf qu’elle utilise des affinités de groupe par opposition aux ID de jeu d’UC pour représenter une liste d’ensembles de processeurs. Cela signifie que les ensembles de processeurs par défaut du processus sont mappés à leurs processeurs de base et que ces processeurs sont récupérés dans la liste résultante des affinités de groupe.

Spécifications


Client minimal pris en charge	Windows 11
Serveur minimal pris en charge	Windows Server 2022
En-tête	processthreadsapi.h
DLL	kernel32.dll

Partager via