GROUP_AFFINITY structure (miniport.h)

  • Article

La structure GROUP_AFFINITY spécifie un numéro de groupe et l’affinité processeur au sein de ce groupe.

Syntaxe

typedef struct _GROUP_AFFINITY {
  KAFFINITY Mask;
  USHORT    Group;
  USHORT    Reserved[3];
} GROUP_AFFINITY, *PGROUP_AFFINITY;

Membres

Mask

Spécifie le masque d’affinité. Ce paramètre est une valeur KAFFINITY . Les bits du masque d’affinité identifient un ensemble de processeurs au sein du groupe identifié par groupe.

Group

Spécifie le numéro de groupe. Dans Windows 7, le numéro de groupe doit être compris entre 0 et 3.

Reserved[3]

Réservé pour un usage futur. Définissez les trois éléments du tableau réservé sur zéro.

Remarques

Cette structure décrit une affinité spécifique au groupe.

Une structure GROUP_AFFINITY peut décrire une affinité de thread, qui est un ensemble de processeurs sur lesquels un thread est autorisé à s’exécuter. Tous les processeurs de cet ensemble appartiennent au groupe identifié par le membre de groupe de la structure. Le membre Mask contient un masque d’affinité qui identifie les processeurs dans l’ensemble. Par exemple, les routines KeSetSystemGroupAffinityThread et KeRevertToUserGroupAffinityThread utilisent des structures GROUP_AFFINITY pour spécifier des affinités de thread.

Une structure GROUP_AFFINITY peut décrire une affinité d’interruption, qui est un ensemble de processeurs sur lesquels une routine de service d’interruption peut recevoir des interruptions. Par exemple, la routine IoGetDeviceNumaNode utilise des structures GROUP_AFFINITY pour spécifier des affinités d’interruption.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge dans Windows 7 et versions ultérieures de Windows.
En-tête miniport.h (inclure Winnt.h, Ntdef.h, Windef.h, Minitape.h)

Voir aussi

IoGetDeviceNumaNode

KAFFINITY

KeRevertToUserGroupAffinityThread

KeSetSystemGroupAffinityThread