Fungsi NdisIfGetNetLuidFromInterfaceIndex (ndis.h)

Artikel
02/29/2024

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

Sintaks

NDIS_STATUS NdisIfGetNetLuidFromInterfaceIndex(
        NET_IFINDEX ifIndex,
  [out] PNET_LUID   pNetLuid
);

Parameter

ifIndex

Indeks antarmuka jaringan yang ditetapkan NDIS ke nilai NET_LUID di Fungsi NdisIfRegisterInterface .

[out] pNetLuid

Penunjuk ke variabel NET_LUID yang disediakan penelepon. Jika NdisIfGetNetLuidFromInterfaceIndex berhasil, NDIS menulis nilai NET_LUID yang terkait dengan indeks antarmuka jaringan yang ditentukan ke variabel ini.

Nilai kembali

NdisIfGetNetLuidFromInterfaceIndex mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	Operasi berhasil diselesaikan.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfGetNetLuidFromInterfaceIndex gagal karena indeks antarmuka jaringan yang ditentukan tidak ditetapkan ke antarmuka terdaftar.

Keterangan

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

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 yang lebih rendah 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 menghidupkan ulang komputer. 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 NdisIfGetInterfaceIndexFromNetLuid untuk mendapatkan indeks antarmuka untuk NET_LUID 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)