FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 fungsi panggilan balik (fwpsk.h)

Artikel
08/07/2023

Mesin filter memanggil fungsi callout vSwitchPolicyEventNotifyFn (FWPS_VSWITCH_POLICY_EVENT_CALLBACK0) untuk memberi tahu driver callout tentang peristiwa kebijakan pengalihan virtual.

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

Sintaks

FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 FwpsVswitchPolicyEventCallback0;

NTSTATUS FwpsVswitchPolicyEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in, optional] const NDIS_SWITCH_PORT_PROPERTY_PARAMETERS *vSwitchPortProperty,
  [in, optional] const NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS *vSwitchPortPropertyDelete
)
{...}

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

Penunjuk ke struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS . Properti port sakelar virtual.

[in, optional] vSwitchPortPropertyDelete

Penunjuk ke struktur NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS . Properti port sakelar virtual.

Nilai kembali

Callout

FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Driver callout menerima pemberitahuan dari mesin filter.
STATUS_PENDING	Operasi tertunda dan akan selesai nanti. Driver callout akan memanggil fungsi FwpsvSwitchNotifyComplete0 untuk menyelesaikan operasi yang tertunda.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Driver callout mendaftarkan fungsi vSwitchPolicyEventNotifyFn dengan memanggil fungsi FwpsvSwitchEventsSubscribe0 .

Jika panggilan balik vSwitchPolicyEventNotifyFn terdaftar, callout pada host target akan diberi tahu tentang kebijakan yang dikonfigurasi untuk port sakelar virtual selama migrasi langsung dan sebelum migrasi VM dapat berjalan pada host baru.

Tanpa migrasi langsung, vSwitchPolicyEventNotifyFn juga akan dipanggil untuk operasi penyimpanan VM.

Perubahan pada kebijakan pemfilteran vendor yang dikonfigurasi melalui antarmuka VMMS WMI diteruskan ke ekstensi sakelar virtual WFP dengan permintaan OID. OID ini membawa struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS dengan anggota PropertyType yang diatur ke jenis NdisSwitchPortPropertyTypeCustom .

Driver filter WFP meneruskan informasi dalam permintaan OID OID_SWITCH_PORT_PROPERTY_ADD ke vSwitchPolicyEventNotifyFn dengan jenis FWPS_VSWITCH_EVENT_POLICY_ADD yang diatur dalam parameter eventType untuk memberi tahu driver callout tentang penambahan properti kebijakan untuk port sakelar virtual.

Driver filter WFP meneruskan informasi dalam permintaan OID OID_SWITCH_PORT_PROPERTY_UPDATE ke vSwitchPolicyEventNotifyFn dengan jenis FWPS_VSWITCH_EVENT_POLICY_UPDATE yang diatur dalam parameter eventType untuk memberi tahu driver filter callout tentang pembaruan properti untuk kebijakan port sakelar virtual.

OID ini juga mencakup GUID pengidentifikasi properti yang secara unik mengidentifikasi penyedia WFP mana kebijakan tersebut berada. GUID pengidentifikasi properti disediakan ketika vendor mengonfigurasi kebijakannya melalui VMMS, dan GUID harus menjadi GUID yang sama yang digunakan vendor untuk mendaftarkan penyedianya dengan WFP.

WFP mencoba mencocokkan GUID pengidentifikasi properti dengan GUID penyedia yang ditentukan dari fungsi FwpsvSwitchEventsSubscribe0 . Jika ada kecocokan, WFP memanggil vSwitchPolicyEventNotifyFn yang sesuai dan meneruskan struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS ke callout.

Driver filter WFP meneruskan informasi dalam permintaan OID OID_SWITCH_PORT_PROPERTY_DELETE ke vSwitchPolicyEventNotifyFn dengan jenis FWPS_VSWITCH_EVENT_POLICY_DELETE yang diatur dalam parameter eventType untuk memberi tahu driver filter callout tentang penghapusan properti kebijakan untuk port sakelar virtual. Properti penghapusan ditentukan dalam struktur NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS .

Jika callout mengembalikan STATUS_PENDING dari vSwitchPolicyEventNotifyFn, WFP mengembalikan STATUS_PENDING ke handler FilterOidRequest . Driver callout akan memanggil fungsi FwpsvSwitchNotifyComplete0 untuk menyelesaikan operasi yang tertunda.

Persyaratan

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