estrutura PROCESSOR_RELATIONSHIP (winnt.h)

Representa informações sobre afinidade em um grupo de processadores. Essa estrutura é usada com a função GetLogicalProcessorInformationEx .

Sintaxe

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

Membros

Flags

Se o membro Relationship da estrutura SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX for RelationProcessorCore, esse membro será LTP_PC_SMT se o núcleo tiver mais de um processador lógico ou 0 se o núcleo tiver um processador lógico.

Se o membro Relationship da estrutura SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX for RelationProcessorPackage, esse membro sempre será 0.

EfficiencyClass

Se o membro Relationship da estrutura SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX for RelationProcessorCore, EfficiencyClass especificará a compensação intrínseca entre desempenho e potência para o núcleo aplicável. Um núcleo com um valor mais alto para a classe de eficiência tem desempenho intrinsecamente maior e menos eficiência do que um núcleo com um valor menor para a classe de eficiência. EfficiencyClass só não é zero em sistemas com um conjunto heterogêneo de núcleos.

Se o membro Relationship da estrutura SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX for RelationProcessorPackage, EfficiencyClass será sempre 0.

A versão mínima do sistema operacional que dá suporte a esse membro é Windows 10.

Reserved[20]

Este membro está reservado.

GroupCount

Esse membro especifica o número de entradas na matriz GroupMask . Para obter mais informações, consulte Comentários.

GroupMask[ANYSIZE_ARRAY]

Uma matriz de estruturas GROUP_AFFINITY . O membro GroupCount especifica o número de estruturas na matriz. Cada estrutura na matriz especifica um número de grupo e afinidade de processador dentro do grupo.

Comentários

A estrutura PROCESSOR_RELATIONSHIP descreve os processadores lógicos associados a um núcleo de processador ou um pacote de processador.

Se a estrutura PROCESSOR_RELATIONSHIP representar um núcleo de processador, o membro GroupCount será sempre 1.

Se a estrutura PROCESSOR_RELATIONSHIP representar um pacote de processador, o membro GroupCount será 1 somente se todos os processadores estiverem no mesmo grupo de processadores. Se o pacote contiver mais de um nó NUMA, o sistema poderá atribuir nós NUMA diferentes a diferentes grupos de processadores. Nesse caso, o membro GroupCount é o número de grupos aos quais os nós NUMA no pacote são atribuídos.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho	winnt.h

Confira também

GROUP_AFFINITY

GetLogicalProcessorInformationEx

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX