NDIS_SWITCH_DEREFERENCE_SWITCH_NIC fungsi panggilan balik (ndis.h)
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