getNumaProximityNodeEx 函数 (systemtopologyapi.h)

  • 项目

检索与指定的邻近感应标识符对应的 NUMA 节点号作为 USHORT 值。

语法

BOOL GetNumaProximityNodeEx(
  [in]  ULONG   ProximityId,
  [out] PUSHORT NodeNumber
);

参数

[in] ProximityId

节点的邻近标识符。

[out] NodeNumber

指向变量以接收指定邻近标识符的节点号。

返回值

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

如果函数失败，则返回值为零。

注解

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

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

GetNumaProximityNodeEx 函数和 GetNumaProximityNode 函数之间的唯一区别是 NodeNumber 参数的数据类型。

若要编译使用此函数的应用程序，请设置 _WIN32_WINNT >= 0x0601。 有关详细信息，请参阅 使用 Windows 标头。

要求

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

另请参阅

GetNumaProximityNode

NUMA 支持