GetProcessDefaultCpuSetMasks, fonction (processthreadsapi.h)

Récupère la liste des jeux d’UC dans le jeu par défaut de processus 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 disposer du 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 jeux d’UC par défaut du processus.

CpuSetMaskCount

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

RequiredMaskCount

Lors d’un 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 de retour

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 requiredMaskCount est définie sur le nombre d’éléments requis.

Remarques

Si aucun jeu 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 de jeux d’UC. 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