FWPS_VSWITCH_FILTER_ENGINE_REORDER_CALLBACK0 fungsi panggilan balik (fwpsk.h)

Artikel
08/07/2023

Mesin filter memanggil fungsi callout vSwitchFilterEngineReorderNotifyRn (FWPS_VSWITCH_FILTER_ENGINE_REORDER_CALLBACK0) untuk memberi tahu driver callout tentang peristiwa yang terkait dengan penyusunan ulang mesin filter sakelar virtual.

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

Sintaks

FWPS_VSWITCH_FILTER_ENGINE_REORDER_CALLBACK0 FwpsVswitchFilterEngineReorderCallback0;

NTSTATUS FwpsVswitchFilterEngineReorderCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           BOOLEAN isInRequiredPosition,
  [in]           const NDIS_ENUM_FILTERS *vSwitchExtensionLwfList
)
{...}

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] isInRequiredPosition

Nilai BOOLEAN yang diatur ke TRUE jika filter berada di posisi yang diperlukan di tumpukan filter atau FALSE jika tidak.

[in] vSwitchExtensionLwfList

Struktur NDIS_ENUM_FILTERS yang menentukan daftar driver filter NDIS ekstensi sakelar virtual.

Nilai kembali

Callout

FWPS_VSWITCH_FILTER_ENGINE_REORDER_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 vSwitchFilterEngineReorderNotifyRn dengan memanggil
fungsi FwpsvSwitchEventsSubscribe0 .

Secara default, ekstensi sakelar virtual WFP diposisikan sebagai ekstensi pemfilteran pertama pada ingress sakelar virtual. (Oleh karena itu, ini juga merupakan ekstensi terakhir pada egress sakelar virtual). Ini biasanya posisi terbaik, karena ekstensi WFP dapat mencegat paket sebelum ekstensi lain dapat memodifikasinya saat masuk. Selain itu, ekstensi WFP dapat mencegat paket setelah semua modifikasi paket dilakukan saat keluar.

Namun, karena administrator dapat menyusun ulang ekstensi sakelar virtual dari kelas yang sama, ekstensi WFP dapat diurutkan ulang dari posisi default. Setelah pengurutan ulang terjadi, filter klien WFP dapat dilewati dan mungkin perlu disesuaikan.

Jika panggilan balik vSwitchFilterEngineReorderNotifyRn terdaftar, driver callout akan diberi tahu saat terjadi pengurutan ulang sakelar virtual. Driver callout menerima struktur NDIS_ENUM_FILTERS dengan daftar ekstensi sakelar virtual saat ini yang diurutkan dalam parameter vSwitchExtensionLwfList .

Jika ekstensi sakelar virtual diurutkan ulang, ekstensi WFP dijeda (lihat FilterPause) dan dimulai ulang (lihat FilterRestart). Dari panggilan FilterRestart filter WFP, driver filter WFP memanggil fungsi NdisEnumerateFilterModules untuk mendapatkan daftar filter ekstensi sakelar virtual yang diurutkan. Jika ekstensi WFP tidak berada dalam posisi default, maka driver filter akan memberi tahu driver callout.

Driver callout tidak dapat mengembalikan STATUS_PENDING dari vSwitchFilterEngineReorderNotifyRn.

Persyaratan

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