FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 fungsi panggilan balik (fwpsk.h)

Artikel
08/07/2023

Mesin filter memanggil fungsi callout vSwitchRuntimeStateRestoreNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0) untuk memberi tahu driver callout tentang peristiwa pemulihan status run-time sakelar virtual.

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

Sintaks

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 FwpsVswitchRuntimeStateRestoreCallback0;

NTSTATUS FwpsVswitchRuntimeStateRestoreCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           NDIS_SWITCH_PORT_ID portId,
                 void *runtimeState,
  [in]           SIZE_T runtimeStateLength
)
{...}

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

Pengidentifikasi port sakelar sumber.

runtimeState

Lokasi buffer hasil output status run-time.

[in] runtimeStateLength

Panjangnya, dalam byte, dari informasi status run-time dalam buffer status run-time.

Nilai kembali

Callout

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_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 vSwitchRuntimeStateRestoreNotifyFn dengan memanggil fungsi FwpsvSwitchEventsSubscribe0 .

Lihat fungsi vSwitchRuntimeStateSaveNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0) untuk informasi tentang menyimpan status run-time.

Setiap segmen data yang disimpan akan dipulihkan dengan OID_SWITCH_NIC_RESTORE OID yang dikirim melalui tumpukan ekstensi sakelar virtual pada sistem target atau pada sistem lokal selama operasi pemulihan. WFP akan mengirimkan data ke callout yang benar melalui vSwitchRuntimeStateRestoreNotifyFn setelah mencocokkan dengan GUID penyedia terdaftar. Dalam hal ini, parameter eventTypevSwitchRuntimeStateRestoreNotifyFn diatur ke FWPS_VSWITCH_EVENT_RUNTIME_STATE_RESTORE.

Callout dapat mengembalikan STATUS_PENDING dari vSwitchRuntimeStateRestoreNotifyFn. Dalam hal ini, WFP akan mengembalikan STATUS_PENDING di handler FilterOidRequest dan akan menyelesaikannya di lain waktu. 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