Fungsi NdisIfGetInterfaceIndexFromNetLuid (ndis.h)

Artikel
03/05/2024

Fungsi NdisIfGetInterfaceIndexFromNetLuid mendapatkan indeks antarmuka jaringan yang terkait dengan nilai NET_LUID .

Sintaks

NDIS_STATUS NdisIfGetInterfaceIndexFromNetLuid(
  [in]  NET_LUID     NetLuid,
  [out] PNET_IFINDEX pIfIndex
);

Parameter

[in] NetLuid

Nilai NET_LUID yang mengidentifikasi antarmuka jaringan.

[out] pIfIndex

Penunjuk ke variabel indeks antarmuka yang disediakan pemanggil. Jika NdisIfGetInterfaceIndexFromNetLuid berhasil, NDIS menulis indeks antarmuka jaringan yang terkait dengan NET_LUID yang ditentukan ke variabel ini.

Nilai kembali

NdisIfGetInterfaceIndexFromNetLuid mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	Operasi berhasil diselesaikan.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfGetInterfaceIndexFromNetLuid gagal karena NET_LUID yang ditentukan tidak ada dalam daftar antarmuka terdaftar.

Keterangan

Driver NDIS dapat memanggil fungsi NdisIfGetInterfaceIndexFromNetLuid untuk mendapatkan indeks antarmuka jaringan yang terkait dengan nilai NET_LUID .

Untuk antarmuka yang dikelola layanan penyedia proksi NDIS, NDIS menyediakan indeks antarmuka dan NET_LUID dalam berbagai struktur inisialisasi driver:

Driver miniport dapat memperoleh indeks antarmuka dan NET_LUID untuk adaptor miniport di NDIS_MINIPORT_INIT_PARAMETERS struktur.
Driver filter dapat memperoleh indeks antarmuka dan NET_LUID untuk modul filter di NDIS_FILTER_ATTACH_PARAMETERS struktur.
Driver protokol dapat memperoleh indeks antarmuka dan NET_LUID antarmuka tertinggi dan terendah pada tumpukan driver dalam struktur NDIS_BIND_PARAMETERS .

NDIS menetapkan indeks antarmuka ke antarmuka jaringan saat penyedia antarmuka memanggil fungsi NdisIfRegisterInterface . Penyedia antarmuka memanggil makro NDIS_MAKE_NET_LUID untuk membuat nilai NET_LUID sebelum mendaftarkan antarmuka.

Nilai indeks antarmuka dapat berubah tanpa komputer dimulai ulang. Membatalkan pendaftaran dan mendaftarkan ulang antarmuka yang terkait dengan nilai NET_LUID dapat mengakibatkan nilai indeks antarmuka yang berbeda. Jangan membingungkan indeks antarmuka dengan indeks NET_LUID yang bertahan setelah komputer dimulai ulang.

NDIS menyediakan Fungsi NdisIfGetNetLuidFromInterfaceIndex untuk mendapatkan nilai NET_LUID yang terkait dengan indeks antarmuka tertentu.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform	Desktop
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	Irql_Interfaces_Function(ndis)