Fungsi IoGetDeviceNumaNode (wdm.h)

  • Artikel

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
STATUS_NOT_FOUND
 Nomor simpul perangkat ini tidak diketahui.
STATUS_INVALID_PARAMETER
 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)

Lihat juga

DEVICE_OBJECT

KeQueryHighestNodeNumber