Fungsi GetNumaProximityNodeEx (systemtopologyapi.h)

Mengambil nomor simpul NUMA yang sesuai dengan pengidentifikasi kedekatan yang ditentukan sebagai nilai USHORT .

Syntax

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

Parameter-parameternya

[in] ProximityId

Pengidentifikasi kedekatan simpul.

[out] NodeNumber

Arahkan ke variabel untuk menerima nomor node untuk pengidentifikasi kedekatan yang ditentukan.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Komentar

Pengidentifikasi domain kedekatan adalah indeks ke simpul NUMA pada sistem NUMA. Pengidentifikasi domain kedekatan ditemukan di Tabel Afinitas Sumber Daya Sistem ACPI (SRAT), 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.

Satu-satunya perbedaan antara fungsi GetNumaProximityNodeEx dan fungsi GetNumaProximityNode adalah jenis data parameter NodeNumber .

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, atur _WIN32_WINNT >= 0x0601. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Platform Target	Windows
Header	systemtopologyapi.h (termasuk Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

GetNumaProximityNode

Dukungan NUMA