GetNumaProximityNode 函数 (winbase.h)

  • 项目

检索与指定的邻近域标识符对应的 NUMA 节点编号。

使用 GetNumaProximityNodeEx 函数检索节点号作为 USHORT 值。

语法

BOOL GetNumaProximityNode(
  [in]  ULONG  ProximityId,
  [out] PUCHAR NodeNumber
);

参数

[in] ProximityId

节点的邻近域标识符。

[out] NodeNumber

节点编号。 如果处理器不存在，则0xFF此参数。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。

注解

邻近域标识符是 NUMA 系统上 NUMA 节点的索引。 邻近域标识符可在 ACPI 系统资源相关性表 (SRAT) 中找到，其中它们用于将处理器和内存区域与特定的 NUMA 节点相关联。 邻近域标识符也位于 ACPI 命名空间中，其中它们用于将设备与特定 NUMA 节点相关联。 邻近域标识符通常仅由系统制造商提供的管理应用程序使用。 Windows 不使用邻近域标识符来标识 NUMA 节点;相反，它会为系统中的每个 NUMA 节点分配一个唯一编号。

系统上节点之间的相对距离存储在 ACPI 系统位置距离信息表中， (SLIT) ，它不会由任何 Windows 函数公开。 有关 ACPI 表的详细信息，请参阅 ACPI 规范。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 winbase.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

GetNumaProcessorNode

GetNumaProximityNodeEx

NUMA 支持