Partager via


set_task_execution_resources, fonction

Restreint les ressources d'exécution utilisées par les threads de travail internes du runtime d'accès concurrentiel à l'affinité spécifiée.

Il n'est pas valide d'appeler cette méthode uniquement avant que le gestionnaire de ressources ait été créé, ou entre deux durées de vie du gestionnaire de ressources. On peut l'appeler plusieurs fois à condition que le gestionnaire de ressources n'existe pas au moment de l'appel. Une fois que la limite d'affinité a été définie, elle demeure effective tant que le prchain appel valide appelle la méthode set_task_execution_resources.

Le masque d'affinité a fourni n'a pas besoin d'être un sous-ensemble du masque d'affinité de processus. L'affinité de processus sera mise à jour si nécessaire.

void __cdecl set_task_execution_resources(
   DWORD_PTR _ProcessAffinityMask
);

void __cdecl set_task_execution_resources(
   unsigned short _Count,
   PGROUP_AFFINITY _PGroupAffinity
);

Paramètres

  • _ProcessAffinityMask
    Le masque d'affinité auquel les threads de travail runtime d'accès concurrentiel doivent être limités. Utilisez cette méthode sur un système avec une valeur supérieure à 64 threads matériels uniquement si vous souhaitez limiter le runtime d'accès concurrentiel à un sous-ensemble de groupe du processeur en cours de exécution. En général vous devez utiliser la version de la méthode qui accepte un tableau d'affinités de groupe comme paramètre, pour restreindre l'affinité sur des ordinateurs dotés supérieur à 64 threads matériels.

  • _Count
    Le nombre d'entrées GROUP_AFFINITY dans le tableau spécifié par le paramètre _PGroupAffinity.

  • _PGroupAffinity
    Un tableau d'entrées GROUP_AFFINITY.

Notes

La méthode lève une exception invalid_operation si un gestionnaire de ressources est présent lors de son appel, et une exception invalid_argument si l'affinité spécifiée aboutit dans un ensemble vide de ressources.

La version de la méthode qui accepte un tableau d'affinités de groupe comme paramètre ne doit être utilisée que sur les systèmes d'exploitation Windows 7 ou une version ultérieure. Sinon, dd470512(v=vs.120).md si l'exception est rejetée.

Modifier par programmation l'affinité de processus après que cette méthode ait été appelée n'entraînera pas le gestionnaire de ressources à réévaluer l'affinité à laquelle il est limité. Par conséquent, toute modification de l'affinité de processus doit être effectuée avant d'appeler cette méthode.

Configuration requise

En-tête : concrt.h

Espace de noms : concurrency

Voir aussi

Référence

concurrency, espace de noms