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

識別此結構所描述之處理器的處理器遮罩。 處理器遮罩是位向量，其中每個設定位都代表關聯性中的作用中處理器。 至少會設定一個位。

在超過 64 個處理器的系統上，處理器遮罩會識別單一 處理器群組中的處理器。

Relationship

ProcessorMask成員值所識別之處理器之間的關聯性。 這個成員可以是下列其中一個 LOGICAL_PROCESSOR_RELATIONSHIP 值。

值	意義
RelationCache 2	指定的邏輯處理器會共用快取。 快取成員包含其他資訊。 Windows Server 2003： 在 Windows Server 2003 SP1 和 Windows XP Professional x64 Edition 之前，不支援此值。
RelationNumaNode 1	指定的邏輯處理器是相同NUMA節點的一部分。 NumaNode 成員包含其他資訊。
RelationProcessorCore 0	指定的邏輯處理器會共用單一處理器核心。 ProcessorCore 成員包含其他資訊。
RelationProcessorPackage 3	指定的邏輯處理器會共享實體套件。 沒有其他可用資訊。 Windows Server 2003 和 Windows XP Professional x64 版本： 在 Windows Server 2003 SP1 和 Windows XP 搭配 SP3 之前，不支援此值。

 

未來的 Windows 版本可能會支援 關聯 性成員的其他值。

DUMMYUNIONNAME

DUMMYUNIONNAME.ProcessorCore

只有當 Relationship 成員為 RelationProcessorCore 時，這個結構才會包含有效的數據。

DUMMYUNIONNAME.ProcessorCore.Flags

如果這個成員的值是 1，則 由 ProcessorMask 成員共用功能單位的值所識別的邏輯處理器，如超線程或 SMT 所示。 否則，識別的邏輯處理器不會共用功能單位。

Windows Server 2003 和 Windows XP Professional x64 版本： 此成員也是共用實體套件的核心 1。 因此，若要判斷處理器是否支援 Windows Vista 之前的系統上多個核心或超線程，請使用 CPUID 指令。

DUMMYUNIONNAME.NumaNode

只有當 Relationship 成員為 RelationNumaNode 時，這個結構才會包含有效的數據。

DUMMYUNIONNAME.NumaNode.NodeNumber

識別 NUMA 節點。 此參數的有效值為 0 到包含的最高 NUMA 節點編號。 非 NUMA 多處理器系統會報告所有處理器都屬於一個 NUMA 節點。

DUMMYUNIONNAME.Cache

識別特定快 取特性的CACHE_DESCRIPTOR 結構。 每個回報的快取都會傳回一筆記錄。 根據處理器用來識別其快取的機制而定，某些或所有快取可能不會報告。 因此，請勿假設沒有任何特定的快取。 快取不一定會在邏輯處理器之間共用。

只有當 Relationship 成員是 RelationCache 時，這個結構才會包含有效的數據。

Windows Server 2003： 在 Windows Server 2003 SP1 和 Windows XP Professional x64 Edition 之前，不支援此成員。

DUMMYUNIONNAME.Reserved[2]

保留的。 請勿使用。

規格需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP Professional x64 Edition [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	winnt.h (包括 Windows.h)

另請參閱

CACHE_DESCRIPTOR

GetLogicalProcessorInformation

GetLogicalProcessorInformationEx

LOGICAL_PROCESSOR_RELATIONSHIP

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX