NDIS_SWITCH_DEREFERENCE_SWITCH_NIC fungsi panggilan balik (ndis.h)

Artikel
08/07/2023

Fungsi DereferenceSwitchNic mengurangi penghitung referensi sakelar yang dapat diperluas Hyper-V untuk adaptor jaringan yang terhubung ke port sakelar yang dapat diperluas. Penghitung referensi dinaikkan melalui panggilan sebelumnya ke ReferenceSwitchNic.

Sintaks

NDIS_SWITCH_DEREFERENCE_SWITCH_NIC NdisSwitchDereferenceSwitchNic;

NDIS_STATUS NdisSwitchDereferenceSwitchNic(
  [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 yang dapat diperluas Hyper-V terpasang. Ketika ekstensi memanggil NdisFGetOptionalSwitchHandlers, handel ini dikembalikan melalui parameter NdisSwitchContext .

[in] SwitchPortId

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

[in] SwitchNicIndex

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

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

Nilai kembali

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

Keterangan

Ekstensi sakelar yang dapat diperluas memanggil DereferenceSwitchNic untuk mengurangi penghitung referensi untuk adaptor jaringan yang terhubung ke port sakelar yang dapat diperluas. Meskipun penghitung referensi sakelar yang dapat diperluas 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.

Ekstensi harus memanggil DereferenceSwitchNic jika sebelumnya disebut ReferenceSwitchNic untuk koneksi adaptor jaringan.

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

Lihat juga

NdisFGetOptionalSwitchHandlers

OID_SWITCH_NIC_DELETE

ReferenceSwitchNic

Share via