FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 fungsi panggilan balik (fwpsk.h)

Artikel
08/07/2023

Mesin filter memanggil fungsi callout vSwitchLifetimeNotifyFn (FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0) untuk memberi tahu driver callout tentang membuat dan menghapus peristiwa untuk sakelar virtual.

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

Sintaks

FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 FwpsVswitchLifetimeEventCallback0;

NTSTATUS FwpsVswitchLifetimeEventCallback0(
  [in, optional] void *notifyContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in, optional] const NDIS_SWITCH_PORT_ARRAY *vSwitchPorts,
  [in, optional] const NDIS_SWITCH_NIC_ARRAY *vSwitchInterfaces
)
{...}

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] 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, optional] vSwitchPorts

Penunjuk ke struktur NDIS_SWITCH_PORT_ARRAY yang menentukan array parameter konfigurasi port. Setiap elemen dalam array menentukan parameter untuk port pada sakelar virtual.

[in, optional] vSwitchInterfaces

Penunjuk ke struktur NDIS_SWITCH_NIC_ARRAY yang menentukan array parameter konfigurasi adaptor miniport. Setiap elemen dalam array menentukan parameter untuk adaptor miniport virtual atau fisik yang dilampirkan ke port pada sakelar virtual.

Nilai kembali

Callout

FWPS_VSWITCH_LIFETIME_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 panggilan balik vSwitchLifetimeNotifyFn dengan memanggil
fungsi FwpsvSwitchEventsSubscribe0 .

Jika panggilan balik vSwitchLifetimeNotifyFn terdaftar, driver filter WFP memberi tahu driver callout saat instans sakelar virtual dibuat. Beberapa instans sakelar virtual dapat hadir di host Hyper-V secara bersamaan.

Driver filter WFP meminta OID_SWITCH_PARAMETERS OID dalam fungsi FilterRestart untuk mendapatkan pengidentifikasi sakelar virtual yang terkait dengan instans sakelar virtual saat ini. Driver filter WFP juga mengkueri OID_SWITCH_NIC_ARRAY dan OID_SWITCH_PORT_ARRAY OID untuk mendapatkan set awal NIC virtual dan port virtual yang dikonfigurasi. Driver filter WFP meneruskan informasi struktur NDIS_SWITCH_PORT_ARRAY dan NDIS_SWITCH_NIC_ARRAY dari OID ke vSwitchLifetimeNotifyFn dengan FWPS_VSWITCH_EVENT_VSWITCH_CREATE diatur dalam parameter eventType .

Di FilterDetach driver filter WFP, filter memanggil dengan FWPS_VSWITCH_EVENT_VSWITCH_DELETE diatur dalam parameter eventTypevSwitchLifetimeNotifyFn .

Driver callout tidak dapat mengembalikan STATUS_PENDING dari vSwitchLifetimeNotifyFn.

Persyaratan

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