PROCESSOR_RELATIONSHIP structure (winnt.h)

  • Article

Représente des informations sur l’affinité au sein d’un groupe de processeurs. Cette structure est utilisée avec la fonction GetLogicalProcessorInformationEx .

Syntaxe

typedef struct _PROCESSOR_RELATIONSHIP {
  BYTE           Flags;
  BYTE           EfficiencyClass;
  BYTE           Reserved[20];
  WORD           GroupCount;
  GROUP_AFFINITY GroupMask[ANYSIZE_ARRAY];
} PROCESSOR_RELATIONSHIP, *PPROCESSOR_RELATIONSHIP;

Membres

Flags

Si le membre Relationship de la structure SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX est RelationProcessorCore, ce membre est LTP_PC_SMT si le cœur a plusieurs processeurs logiques, ou 0 si le cœur a un processeur logique.

Si le membre Relationship de la structure SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX est RelationProcessorPackage, ce membre est toujours 0.

EfficiencyClass

Si le membre Relationship de la structure SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX est RelationProcessorCore, EfficiencyClass spécifie le compromis intrinsèque entre les performances et la puissance pour le cœur applicable. Un cœur avec une valeur plus élevée pour la classe d’efficacité a intrinsèquement des performances et moins d’efficacité qu’un cœur avec une valeur inférieure pour la classe d’efficacité. EfficiencyClass n’est pas zéro sur les systèmes avec un ensemble hétérogène de cœurs.

Si le membre Relationship de la structure SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX est RelationProcessorPackage, EfficiencyClass est toujours 0.

La version minimale du système d’exploitation qui prend en charge ce membre est Windows 10.

Reserved[20]

Ce membre est réservé.

GroupCount

Ce membre spécifie le nombre d’entrées dans le tableau GroupMask . Pour plus d'informations, consultez la section Notes.

GroupMask[ANYSIZE_ARRAY]

Tableau de structures GROUP_AFFINITY . Le membre GroupCount spécifie le nombre de structures dans le tableau. Chaque structure du tableau spécifie un numéro de groupe et une affinité de processeur au sein du groupe.

Remarques

La structure PROCESSOR_RELATIONSHIP décrit les processeurs logiques associés à un cœur de processeur ou à un package de processeur.

Si la structure PROCESSOR_RELATIONSHIP représente un cœur de processeur, le membre GroupCount est toujours 1.

Si la structure PROCESSOR_RELATIONSHIP représente un package de processeurs, le membre GroupCount est 1 uniquement si tous les processeurs se trouvent dans le même groupe de processeurs. Si le package contient plusieurs nœuds NUMA, le système peut affecter différents nœuds NUMA à différents groupes de processeurs. Dans ce cas, le membre GroupCount est le nombre de groupes auxquels les nœuds NUMA du package sont affectés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
En-tête winnt.h

Voir aussi

GROUP_AFFINITY

GetLogicalProcessorInformationEx

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX