Fungsi IoGetDeviceNumaNode (wdm.h)
Rutinitas IoGetDeviceNumaNode mendapatkan nomor node perangkat.
Sintaks
NTSTATUS IoGetDeviceNumaNode(
[in] PDEVICE_OBJECT Pdo,
[out] PUSHORT NodeNumber
);
Parameter
[in] Pdo
Penunjuk ke objek perangkat fisik (PDO). Parameter ini menunjuk ke struktur DEVICE_OBJECT yang mewakili perangkat fisik.
[out] NodeNumber
Penunjuk ke lokasi tempat rutin menulis nomor simpul, jika nomor simpul diketahui.
Nilai kembali
IoGetDeviceNumaNode mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan meliputi yang berikut ini:
Menampilkan kode | Deskripsi |
---|---|
|
Nomor simpul perangkat ini tidak diketahui. |
|
Parameter Pdo adalah NULL atau tidak menunjuk ke objek perangkat yang valid. |
Keterangan
Dalam arsitektur multiprosesor akses memori non-seragam (NUMA), simpul adalah kumpulan prosesor yang berbagi akses cepat ke wilayah memori. Akses memori tidak seragam karena prosesor dapat mengakses memori dalam simpulnya lebih cepat daripada dapat mengakses memori di simpul lain.
Perangkat (misalnya, pengontrol jaringan atau pengontrol penyimpanan) yang terhubung ke simpul tertentu dapat mengakses memori dalam simpul ini lebih cepat daripada yang dapat mengakses memori di simpul lain. Parameter Pdo menunjuk ke PDO yang mewakili koneksi bus antara perangkat dan simpul.
Jika sistem multiprosedur NUMA berisi simpul n , simpul diberi nomor dari 0 hingga n-1. Untuk mendapatkan nomor node tertinggi, hubungi rutinitas KeQueryHighestNodeNumber .
Setelah sistem diinisialisasi, jumlah node tetap diperbaiki saat sistem terus berjalan. Jumlah ini mungkin mencakup simpul hanya memori, yang merupakan simpul yang berisi memori tetapi tidak ada prosesor logis aktif. Simpul di mana semua prosesor logis tidak aktif secara efektif merupakan simpul hanya memori sampai prosesor pertama dalam simpul mulai berjalan. Jangan berasumsi bahwa simpul yang terhubung dengan perangkat berisi prosesor aktif.
Jika sistem tidak memiliki arsitektur NUMA, rutinitas menulis nol ke lokasi yang dirujuk parameter NodeNumber . Contoh arsitektur non-NUMA adalah sistem multiproseksor simetris (SMP).
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia di Windows 7 dan versi yang lebih baru dari sistem operasi Windows. |
Target Platform | Universal |
Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
Aturan kepatuhan DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |