Fungsi GetNumaProximityNode (winbase.h)

Mengambil nomor simpul NUMA yang sesuai dengan pengidentifikasi domain kedekatan yang ditentukan.

Gunakan fungsi GetNumaProximityNodeEx untuk mengambil nomor simpul sebagai nilai USHORT .

Sintaks

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

Parameter

[in] ProximityId

Pengidentifikasi domain kedekatan simpul.

[out] NodeNumber

Nomor simpul. Jika prosesor tidak ada, parameter ini 0xFF.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Pengidentifikasi domain kedekatan adalah indeks ke simpul NUMA pada sistem NUMA. Pengidentifikasi domain kedekatan ditemukan di Tabel Afinitas Sumber Daya Sistem (SRAT) ACPI, di mana mereka digunakan untuk mengaitkan prosesor dan wilayah memori dengan simpul NUMA tertentu. Pengidentifikasi domain kedekatan juga ditemukan di namespace ACPI, di mana mereka digunakan untuk mengaitkan perangkat dengan simpul NUMA tertentu. Pengidentifikasi domain kedekatan biasanya hanya digunakan oleh aplikasi manajemen yang disediakan oleh produsen sistem. Windows tidak menggunakan pengidentifikasi domain kedekatan untuk mengidentifikasi simpul NUMA; sebaliknya, ia menetapkan angka unik untuk setiap simpul NUMA dalam sistem.

Jarak relatif antara simpul pada sistem disimpan dalam Tabel Informasi Jarak Lokalitas Sistem ACPI (SLIT), yang tidak diekspos oleh fungsi Windows apa pun. Untuk informasi selengkapnya tentang tabel ACPI, lihat spesifikasi ACPI.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

GetNumaProcessorNode

GetNumaProximityNodeEx

Dukungan NUMA