Fonction SetProcessDefaultCpuSetMasks (processthreadsapi.h)

Article
03/04/2024

Définit l’attribution par défaut des jeux d’UC pour les threads dans le processus spécifié.

Syntaxe

BOOL SetProcessDefaultCpuSetMasks(
  HANDLE          Process,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount
);

Paramètres

Process

Spécifie le processus pour lequel définir les ensembles d’UC par défaut. Ce handle doit avoir le droit d’accès PROCESS_SET_LIMITED_INFORMATION . La valeur retournée par GetCurrentProcess peut également être spécifiée ici.

CpuSetMasks

Spécifie une mémoire tampon facultative de structures GROUP_AFFINITY représentant les ensembles de processeurs à définir comme ensemble de processeurs par défaut de processus. Si cette valeur est NULL, la fonction SetProcessDefaultCpuSetMasks efface toute affectation.

CpuSetMaskCount

Spécifie la taille du tableau CpuSetMasks , en éléments. Si la mémoire tampon a la valeur NULL, cette valeur doit être égale à zéro.

Valeur retournée

Cette fonction ne peut pas échouer quand des paramètres valides ont été transmis.

Remarques

Les threads appartenant à ce processus qui n’ont pas de jeux d’UC explicitement définis à l’aide de SetThreadSelectedCpuSetMasks ou SetThreadSelectedCpuSets héritent automatiquement des jeux spécifiés par SetProcessDefaultCpuSetMasks .

Cette fonction est analogue à SetProcessDefaultCpuSets, 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 l’attribution de l’ensemble de processeurs par défaut du processus résultant est l’ensemble de tous les ensembles de processeurs avec un processeur de base dans la liste fournie d’affinités de groupe.

Configuration requise

Condition requise	Valeur
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