Fungsi GetNumaProximityNodeEx (systemtopologyapi.h)
Mengambil nomor simpul NUMA yang sesuai dengan pengidentifikasi kedekatan yang ditentukan sebagai nilai USHORT .
Sintaks
BOOL GetNumaProximityNodeEx(
[in] ULONG ProximityId,
[out] PUSHORT NodeNumber
);
Parameter
[in] ProximityId
Pengidentifikasi kedekatan simpul.
[out] NodeNumber
Menunjuk ke variabel untuk menerima nomor simpul untuk pengidentifikasi kedekatan yang ditentukan.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol.
Keterangan
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] |
Target Platform | Windows |
Header | systemtopologyapi.h (termasuk Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |