Fungsi NdisIfQueryBindingIfIndex (ndis.h)

Artikel
08/07/2023

Fungsi NdisIfQueryBindingIfIndex mengambil indeks antarmuka jaringan dan nilai NET_LUID untuk antarmuka jaringan berlapis tertinggi dan terendah yang terkait dengan pengikatan protokol tertentu.

Sintaks

NDIS_STATUS NdisIfQueryBindingIfIndex(
  [in]  NDIS_HANDLE  NdisBindingHandle,
  [out] PNET_IFINDEX pBoundIfIndex,
  [out] PNET_LUID    pBoundIfNetLuid,
  [out] PNET_IFINDEX pLowestIfIndex,
  [out] PNET_LUID    pLowestIfNetLuid
);

Parameter

[in] NdisBindingHandle

Handel yang mengidentifikasi pengikatan yang NDIS-nya harus mendapatkan nilai NET_LUID dan indeks antarmuka jaringan. NDIS menyediakan handel ini pada parameter NdisBindingHandle dari fungsi NdisOpenAdapterEx .

[out] pBoundIfIndex

Penunjuk ke variabel indeks antarmuka yang disediakan penelepon. Jika NdisIfQueryBindingIfIndex berhasil, NDIS menulis ke variabel ini indeks antarmuka jaringan antarmuka jaringan yang terkait dengan pengikatan yang ditentukan dan tertinggi dalam tumpukan driver.

[out] pBoundIfNetLuid

Penunjuk ke variabel NET_LUID yang disediakan penelepon. Jika NdisIfQueryBindingIfIndex berhasil, NDIS menulis ke variabel ini nilai NET_LUID antarmuka jaringan yang terkait dengan pengikatan yang ditentukan dan tertinggi dalam tumpukan driver.

[out] pLowestIfIndex

[out] pLowestIfNetLuid

Nilai kembali

NdisIfQueryBindingIfIndex mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	Operasi berhasil diselesaikan.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfQueryBindingIfIndex gagal karena pengikatan yang ditentukan tidak terkait dengan antarmuka terdaftar.

Keterangan

Driver protokol NDIS dapat memanggil fungsi NdisIfQueryBindingIfIndex untuk mengambil indeks antarmuka jaringan dan nilai NET_LUID yang terkait dengan pengikatan.

NdisIfQueryBindingIfIndex menyediakan nilai NET_LUID dan indeks antarmuka untuk antarmuka tertinggi dan antarmuka terendah yang terkait dengan pengikatan. Nilai-nilai ini berbeda, misalnya, jika adaptor miniport yang terkait langsung dengan pengikatan yang ditentukan adalah miniport virtual driver perantara filter atau jika ada modul filter yang dikonfigurasi melalui adaptor miniport.

Driver protokol juga dapat memperoleh indeks antarmuka dan NET_LUID antarmuka tertinggi dan terendah dalam tumpukan driver dalam struktur NDIS_BIND_PARAMETERS .

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)

Lihat juga

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx