SYSTEM_LOGICAL_PROCESSOR_INFORMATION構造体 (winnt.h)

指定したプロセッサ セット間のリレーションシップについて説明します。 この構造体は 、GetLogicalProcessorInformation 関数と共に使用されます。

構文

typedef struct _SYSTEM_LOGICAL_PROCESSOR_INFORMATION {
  ULONG_PTR                      ProcessorMask;
  LOGICAL_PROCESSOR_RELATIONSHIP Relationship;
  union {
    struct {
      BYTE Flags;
    } ProcessorCore;
    struct {
      DWORD NodeNumber;
    } NumaNode;
    CACHE_DESCRIPTOR Cache;
    ULONGLONG        Reserved[2];
  } DUMMYUNIONNAME;
} SYSTEM_LOGICAL_PROCESSOR_INFORMATION, *PSYSTEM_LOGICAL_PROCESSOR_INFORMATION;

メンバー

ProcessorMask

この構造体によって記述されるプロセッサを識別するプロセッサ マスク。 プロセッサ マスクは、各セット ビットがリレーションシップ内のアクティブなプロセッサを表すビット ベクトルです。 少なくとも 1 ビットが設定されます。

プロセッサが 64 を超えるシステムでは、プロセッサ マスクによって 1 つの プロセッサ グループ内のプロセッサが識別されます。

Relationship

ProcessorMask メンバーの値によって識別されるプロセッサ間の関係。 このメンバーには、次のいずれかの LOGICAL_PROCESSOR_RELATIONSHIP 値を指定できます。

今後のバージョンの Windows では、 リレーションシップ メンバーの追加の値がサポートされる場合があります。

DUMMYUNIONNAME

DUMMYUNIONNAME.ProcessorCore

この構造体には、 Relationship メンバーが RelationProcessorCore の場合にのみ有効なデータが含まれます。

DUMMYUNIONNAME.ProcessorCore.Flags

このメンバーの値が 1 の場合、 ProcessorMask メンバーの値で識別される論理プロセッサは、Hyperthreading または SMT のように機能単位を共有します。 それ以外の場合、識別された論理プロセッサは機能単位を共有しません。

Windows Server 2003 および Windows XP Professional x64 Edition: このメンバーは、物理パッケージを共有するコアの場合も 1 です。 そのため、プロセッサが Windows Vista より前のシステムで複数のコアまたはハイパースレッディングをサポートしているかどうかを判断するには、CPUID 命令を使用します。

DUMMYUNIONNAME.NumaNode

この構造体には、 Relationship メンバーが RelationNumaNode の場合にのみ有効なデータが含まれます。

DUMMYUNIONNAME.NumaNode.NodeNumber

NUMA ノードを識別します。 このパラメーターの有効な値は、0 から最大の NUMA ノード番号までです。 NUMA 以外のマルチプロセッサ システムは、すべてのプロセッサが 1 つの NUMA ノードに属していることを報告します。

DUMMYUNIONNAME.Cache

特定のキャッシュの特性を識別する CACHE_DESCRIPTOR 構造体。 報告されるキャッシュごとに 1 つのレコードが返されます。 プロセッサがキャッシュを識別するために使用するメカニズムによっては、一部またはすべてのキャッシュが報告されない場合があります。 そのため、特定のキャッシュがないと想定しないでください。 キャッシュは必ずしも論理プロセッサ間で共有されるとは限りません。

この構造体には、 Relationship メンバーが RelationCache の場合にのみ有効なデータが含まれます。

Windows Server 2003: このメンバーは、Windows Server 2003 SP1 および Windows XP Professional x64 Edition までサポートされていません。

DUMMYUNIONNAME.Reserved[2]

予約済み。 使用しないでください。

要件

こちらもご覧ください

CACHE_DESCRIPTOR

GetLogicalProcessorInformation

GetLogicalProcessorInformationEx

LOGICAL_PROCESSOR_RELATIONSHIP

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX