NDIS_SWITCH_REFERENCE_SWITCH_NIC fungsi panggilan balik (ndis.h)

Artikel
02/29/2024

Fungsi ReferenceSwitchNic menambah penghitung referensi sakelar yang dapat diperluas Hyper-V untuk adaptor jaringan yang terhubung ke port sakelar yang dapat diperluas.

Sintaks

NDIS_SWITCH_REFERENCE_SWITCH_NIC NdisSwitchReferenceSwitchNic;

NDIS_STATUS NdisSwitchReferenceSwitchNic(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId,
  [in] NDIS_SWITCH_NIC_INDEX SwitchNicIndex
)
{...}

Parameter

[in] NdisSwitchContext

Nilai NDIS_SWITCH_CONTEXT yang berisi handel modul sakelar yang dapat diperluas tempat ekstensi sakelar hyper-V yang dapat diperluas terpasang. Ketika ekstensi memanggil NdisFGetOptionalSwitchHandlers, handel ini dikembalikan melalui parameter NdisSwitchContext .

[in] SwitchPortId

Nilai NDIS_SWITCH_PORT_ID yang berisi pengidentifikasi unik port sakelar yang dapat diperluas tempat adaptor jaringan virtual terhubung.

[in] SwitchNicIndex

Nilai NDIS_SWITCH_NIC_INDEX yang menentukan indeks adaptor jaringan virtual tempat penghitung referensi sakelar yang dapat diperluas akan dinaikkan.

Untuk informasi selengkapnya tentang nilai NDIS_SWITCH_NIC_INDEX, lihat Nilai Indeks Adapter Jaringan.

Catatan Parameter ini harus menentukan nilai indeks adaptor jaringan yang dalam keadaan tersambung. Nilai indeks untuk adaptor jaringan yang berada dalam status dibuat atau terputus tidak dapat ditentukan. Untuk informasi selengkapnya tentang status koneksi jaringan, lihat Port Sakelar Yang Dapat Diperluas Hyper-V dan Status Adaptor Jaringan.

Nilai kembali

Jika panggilan berhasil, fungsi akan mengembalikan NDIS_STATUS_SUCCESS. Jika tidak, kode kesalahan NDIS_STATUS_Xxx yang ditentukan dalam Ndis.h.

Keterangan

Ekstensi sakelar yang dapat diperluas memanggil ReferenceSwitchNic untuk menambah penghitung referensi untuk adaptor jaringan yang terhubung ke port sakelar yang dapat diperluas. Meskipun penghitung referensi memiliki nilai bukan nol, tepi protokol sakelar yang dapat diperluas tidak akan mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SWITCH_NIC_DELETE untuk menghapus koneksi ke adaptor.

Setelah ekstensi memanggil ReferenceSwitchNic, ekstensi harus memanggil DereferenceSwitchNic untuk mengurangi penghitung referensi sakelar yang dapat diperluas.

Ekstensi harus memanggil ReferenceSwitchNic sebelum melakukan operasi berikut:

Meneruskan permintaan OID OID_SWITCH_NIC_REQUEST melalui jalur kontrol sakelar yang dapat diperluas ke adaptor jaringan fisik yang mendasar.
Untuk informasi selengkapnya, lihat Mengelola Permintaan OID ke Adaptor Jaringan Fisik.
Meneruskan indikasi status NDIS_STATUS_SWITCH_NIC_STATUS di atas jalur kontrol sakelar yang dapat diperluas dari adaptor eksternal yang mendasar.
Untuk informasi selengkapnya, lihat Mengelola Indikasi Status NDIS dari Adaptor Jaringan Fisik.

Catatan Ekstensi tidak boleh memanggil ReferenceSwitchNic saat meneruskan paket melalui jalur data sakelar yang dapat diperluas. Antarmuka sakelar yang dapat diperluas mengelola penghitung referensinya sendiri untuk paket yang diteruskan ke port dan koneksi adaptor jaringan melalui jalur data.

Ekstensi memanggil ReferenceSwitchNic setelah koneksi adaptor jaringan mencapai status koneksi adaptor Jaringan yang dibuat . Ekstensi tidak boleh memanggil ReferenceSwitchNic setelah koneksi mencapai adaptor Jaringan terputus atau Status adaptor jaringan dihapus . Untuk informasi selengkapnya tentang status ini, lihat Port Sakelar Hyper-V dan Status Adaptor Jaringan yang Dapat Diperluas.

Catatan Ketika ekstensi memanggil ReferenceSwitchNic, ekstensi tidak harus menyinkronkan panggilan dengan kodenya yang menangani permintaan OID. Akibatnya, dimungkinkan bagi ekstensi untuk memanggil ReferenceSwitchNic sementara tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan OID OID_SWITCH_NIC_DISCONNECT. Namun, jika panggilan ke ReferenceSwitchNic selesai dengan NDIS_STATUS_SUCCESS, ekstensi masih dapat meneruskan OID_SWITCH_NIC_REQUEST permintaan OID atau NDIS_STATUS_SWITCH_NIC_STATUS indikasi status setelah menangani permintaan OID OID_SWITCH_NIC_DISCONNECT.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.30 dan yang lebih baru.
Target Platform	Desktop
Header	ndis.h (termasuk Ndis.h)
IRQL	<= DISPATCH_LEVEL