NDIS_SWITCH_DEREFERENCE_SWITCH_PORT fungsi panggilan balik (ndis.h)

  • Artikel

Fungsi DereferenceSwitchPort mengurangi penghitung referensi sakelar yang dapat diperluas Hyper-V untuk port sakelar yang dapat diperluas. Penghitung referensi dinaikkan melalui panggilan sebelumnya ke ReferenceSwitchPort.

Sintaks

NDIS_SWITCH_DEREFERENCE_SWITCH_PORT NdisSwitchDereferenceSwitchPort;

NDIS_STATUS NdisSwitchDereferenceSwitchPort(
  [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.

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 DereferenceSwitchPort untuk mengurangi penghitung referensi untuk 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_PORT_DELETE untuk menghapus port.

Ekstensi harus memanggil DereferenceSwitchPort jika sebelumnya disebut ReferenceSwitchPort untuk port sakelar yang dapat diperluas.

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_PORT_DELETE

ReferenceSwitchPort