FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 fungsi panggilan balik (fwpsk.h)
Mesin filter memanggil fungsi callout vSwitchRuntimeStateSaveNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0) untuk memberi tahu driver callout tentang peristiwa penyimpanan status run-time sakelar virtual.
Catatan
FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 adalah versi FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK tertentu. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.
Sintaks
FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 FwpsVswitchRuntimeStateSaveCallback0;
NTSTATUS FwpsVswitchRuntimeStateSaveCallback0(
[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,
[out] 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.
[out] runtimeStateLength
Panjang, dalam byte, dari informasi status run-time dalam buffer status run-time.
Nilai kembali
Fungsi FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 callout 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 vSwitchRuntimeStateSaveNotifyFn dengan memanggil fungsi FwpsvSwitchEventsSubscribe0 .
Jika panggilan balik vSwitchRuntimeStateSaveNotifyFn terdaftar, callout akan diberi tahu untuk mengambil status run-time VM sumber dan untuk memulihkan status run-time VM target selama migrasi langsung atau operasi penyimpanan dan pemulihan lokal. Dalam kasus penyimpanan, parameter eventTypevSwitchRuntimeStateSaveNotifyFn diatur ke FWPS_VSWITCH_EVENT_RUNTIME_STATE_SAVE.
Driver protokol ekstensi sakelar virtual mengeluarkan permintaan metode pengidentifikasi objek (OID) OID_SWITCH_NIC_SAVE selama operasi untuk menyimpan data run-time untuk port sakelar virtual. Driver filter mengembalikan data ini sehingga data run-time untuk port sakelar virtual dapat disimpan dan dipulihkan di lain waktu.
Setelah blob data run-time dari semua callout dikumpulkan, WFP mengisi struktur NDIS_SWITCH_NIC_SAVE_STATE dengan data yang dipanen dan menyelesaikan permintaan status penyimpanan.
Callout dapat mengembalikan STATUS_PENDING dari vSwitchRuntimeStateSaveNotifyFn. 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.
Lihat fungsi vSwitchRuntimeStateRestoreNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0) untuk informasi tentang memulihkan status run-time.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows 8. |
Target Platform | Windows |
Header | fwpsk.h (termasuk Fwpsk.h) |
IRQL | <= DISPATCH_LEVEL |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk