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 |