GetThreadSelectedCpuSetMasks, fonction (processthreadsapi.h)

Retourne l’affectation explicite du jeu d’UC du thread spécifié, si une affectation a été définie à l’aide de SetThreadSelectedCpuSetMasks ou SetThreadSelectedCpuSets.

Syntaxe

BOOL GetThreadSelectedCpuSetMasks(
  HANDLE          Thread,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

Paramètres

Thread

Spécifie le thread pour lequel interroger les jeux d’UC sélectionnés. 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 sélectionnés par thread.

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 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 aucune attribution explicite n’est définie, RequiredMaskCount a la valeur 0 et la fonction réussit.

Cette fonction est analogue à GetThreadSelectedCpuSets, 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 jeux d’UC sélectionnés par thread 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