FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 fungsi panggilan balik (fwpsk.h)

Artikel
02/26/2024

Mesin filter memanggil fungsi callout vSwitchInterfaceEventNotifyFn (FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0) untuk memberi tahu driver callout tentang peristiwa yang terkait dengan antarmuka sakelar virtual.

CatatanFWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 adalah versi FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK tertentu. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.

Sintaks

FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 FwpsVswitchInterfaceEventCallback0;

NTSTATUS FwpsVswitchInterfaceEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           const NDIS_SWITCH_NIC_PARAMETERS *vSwitchNic
)
{...}

Parameter

[in, optional] notifyContext

Penunjuk ke konteks yang disediakan oleh driver callout. Driver meneruskan pointer ini ke parameter notifyContext dari fungsi FwpsvSwitchEventsSubscribe0 . Parameter ini bersifat opsional dan dapat berupa NULL.

[in] completionContext

Penunjuk ke konteks penyelesaian yang disediakan oleh driver callout. Parameter ini bersifat opsional dan dapat berupa NULL.

[in] eventType

Jenis peristiwa sakelar virtual yang ditentukan sebagai salah satu nilai enumerasi FWPS_VSWITCH_EVENT_TYPE . Untuk informasi selengkapnya, lihat Keterangan.

[in] vSwitch

Penunjuk ke struktur NDIS_SWITCH_PARAMETERS yang berisi informasi tentang sakelar virtual.

Catatan Informasi dalam struktur NDIS_SWITCH_PARAMETERS mencerminkan status awal sakelar virtual, belum tentu statusnya saat ini. Secara khusus, anggota NumSwitchPorts dan IsActive mungkin masih memiliki nilai awal nol, kecuali jika peristiwa PnP sakelar virtual telah dipicu. Informasi status saat ini dapat ditemukan di parameter lain untuk fungsi panggilan balik ini.

[in] vSwitchNic

Penunjuk ke struktur NDIS_SWITCH_NIC_PARAMETERS yang menentukan parameter untuk adaptor miniport virtual yang terhubung ke port sakelar virtual.

Nilai kembali

Callout

FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Driver callout menerima pemberitahuan dari mesin filter.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Driver callout mendaftarkan
Fungsi vSwitchInterfaceEventNotifyFn dengan memanggil
fungsi FwpsvSwitchEventsSubscribe0 .

Jika parameter eventType diatur ke WPS_VSWITCH_EVENT_INTERFACE_CREATE, koneksi jaringan baru antara port sakelar virtual dan adaptor jaringan benar-benar dibuat. Parameter vSwitchNic mengidentifikasi struktur NDIS_SWITCH_NIC_PARAMETERS yang berisi informasi tentang adaptor jaringan virtual yang terhubung ke port sakelar virtual.

Jika parameter eventType FWPS_VSWITCH_EVENT_INTERFACE_DISCONNECT, koneksi antara port sakelar virtual dan adaptor jaringan sedang ditumbangkan. Setelah koneksi benar-benar terkoyak, driver filter WFP akan memanggil vSwitchInterfaceEventNotifyFn dengan FWPS_VSWITCH_EVENT_INTERFACE_DELETE diatur dalam parameter eventType .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 8.
Target Platform	Windows
Header	fwpsk.h (termasuk Fwpsk.h)
IRQL	<= DISPATCH_LEVEL