PROCESSOR_RELATIONSHIP 構造体 (winnt.h)

プロセッサ グループ内のアフィニティに関する情報を表します。 この構造体は 、GetLogicalProcessorInformationEx 関数と共に使用されます。

構文

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

メンバー

Flags

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX構造体の Relationship メンバーが RelationProcessorCore の場合、コアに複数の論理プロセッサがある場合はこのメンバーがLTP_PC_SMTされ、コアに 1 つの論理プロセッサがある場合は 0 になります。

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX構造体の Relationship メンバーが RelationProcessorPackage の場合、このメンバーは常に 0 になります。

EfficiencyClass

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX構造体の Relationship メンバーが RelationProcessorCore の場合、EfficiencyClass は、該当するコアのパフォーマンスと電力の間の本質的なトレードオフを指定します。 効率クラスの値が高いコアは、効率クラスの値が小さいコアよりも本質的にパフォーマンスが高く、効率が低くなります。 異種コア セットを持つシステムでは、EfficiencyClass は 0 以外の値のみです。

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX構造体の Relationship メンバーが RelationProcessorPackage の場合、EfficiencyClass は常に 0 になります。

このメンバーをサポートするオペレーティング システムの最小バージョンはWindows 10。

Reserved[20]

このメンバーは予約されています。

GroupCount

このメンバーは、 GroupMask 配列内のエントリの数を指定します。 詳細については、「解説」を参照してください。

GroupMask[ANYSIZE_ARRAY]

GROUP_AFFINITY構造体の配列。 GroupCount メンバーは、配列内の構造体の数を指定します。 配列内の各構造体は、グループ番号とグループ内のプロセッサ アフィニティを指定します。

注釈

PROCESSOR_RELATIONSHIP構造体は、プロセッサ コアまたはプロセッサ パッケージに関連付けられている論理プロセッサを記述します。

PROCESSOR_RELATIONSHIP構造体がプロセッサ コアを表す場合、GroupCount メンバーは常に 1 になります。

PROCESSOR_RELATIONSHIP構造体がプロセッサ パッケージを表す場合、GroupCount メンバーは、すべてのプロセッサが同じプロセッサ グループ内にある場合にのみ 1 になります。 パッケージに複数の NUMA ノードが含まれている場合、システムによって異なる NUMA ノードが異なるプロセッサ グループに割り当てられる可能性があります。 この場合、 GroupCount メンバーは、パッケージ内の NUMA ノードが割り当てられているグループの数です。

要件

こちらもご覧ください

GROUP_AFFINITY

GetLogicalProcessorInformationEx

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX