共用方式為


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 標頭

需求

Requirement 價值觀
最低支援的用戶端 Windows 7 [僅限桌面應用程式]
支援的最低伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平臺 窗戶
Header systemtopologyapi.h(包含 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另請參閱

GetNumaProximityNode

NUMA 支援