取得對應指定鄰近識別碼的 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 標頭。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 7 [僅限桌面應用程式] |
| 支援的最低伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| Header | systemtopologyapi.h(包含 Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |