NDIS_SWITCH_REFERENCE_SWITCH_PORT fungsi panggilan balik (ndis.h)

Artikel
03/01/2024

Fungsi ReferenceSwitchPort menaikkan penghitung referensi sakelar yang dapat diperluas Hyper-V untuk port sakelar yang dapat diperluas.

Sintaks

NDIS_SWITCH_REFERENCE_SWITCH_PORT NdisSwitchReferenceSwitchPort;

NDIS_STATUS NdisSwitchReferenceSwitchPort(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId
)
{...}

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 di mana penghitung referensi sakelar yang dapat diperluas ditambahkan.

Catatan Parameter SwitchPortId harus menentukan pengidentifikasi port yang dalam status dibuat. Pengidentifikasi untuk port yang berada dalam status sobek atau dihapus tidak dapat ditentukan. Untuk informasi selengkapnya tentang status port, lihat Port Hyper-V Extensible Switch dan Status 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 ReferenceSwitchPort untuk menaikkan penghitung referensi untuk 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_PORT_DELETE untuk menghapus port sakelar yang dapat diperluas.

Setelah ekstensi memanggil ReferenceSwitchPort, ekstensi harus memanggil DereferenceSwitchPort untuk mengurangi penghitung referensi.

Ekstensi memanggil ReferenceSwitchPort setelah port mencapai status pembuatan Port . Ekstensi tidak boleh memanggil ReferenceSwitchPort setelah koneksi mencapai Port yang merobek atau Port tidak membuat status. Untuk informasi selengkapnya tentang status ini, lihat Port Hyper-V Extensible Switch dan Status Adaptor Jaringan.

Ekstensi harus memanggil ReferenceSwitchPort ketika melakukan operasi apa pun yang mengharuskan port berada dalam status aktif. Misalnya, ekstensi harus memanggil ReferenceSwitchPort sebelum mengeluarkan permintaan metode OID OID_SWITCH_PORT_PROPERTY_ENUM.

Ekstensi memanggil ReferenceSwitchPort setelah port mencapai status pembuatan Port . Ekstensi tidak boleh memanggil ReferenceSwitchNic setelah port mencapai status Port turun . Untuk informasi selengkapnya tentang status ini, lihat Port Hyper-V Extensible Switch dan Status Adaptor Jaringan.

Catatan Ketika ekstensi memanggil ReferenceSwitchPort, ekstensi tidak harus menyinkronkan panggilan dengan kodenya yang menangani permintaan OID. Akibatnya, ekstensi dapat memanggil ReferenceSwitchPort sementara tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan OID OID_SWITCH_PORT_TEARDOWN. Namun, jika panggilan ke ReferenceSwitchPort selesai dengan NDIS_STATUS_SUCCESS, ekstensi masih dapat mengeluarkan permintaan OID OID_SWITCH_PORT_PROPERTY_ENUM setelah menangani permintaan OID OID_SWITCH_PORT_TEARDOWN.

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