Fungsi FwpsvSwitchEventsSubscribe0 (fwpsk.h)

Artikel
02/29/2024

Fungsi FwpsvSwitchEventsSubscribe0 mendaftarkan titik masuk panggilan balik untuk peristiwa lapisan sakelar virtual seperti pembuatan dan penghapusan port virtual.

CatatanFwpsvSwitchEventsSubscribe0 adalah versi spesifik dari FwpsvSwitchEventsSubscribe. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.

Sintaks

NTSTATUS FwpsvSwitchEventsSubscribe0(
  const GUID                              *providerGuid,
  void                                    *notifyContext,
  UINT32                                  flags,
  void                                    *reserved,
  const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
  UINT32                                  *subscriptionId
);

Parameter

providerGuid

GUID penyedia.

notifyContext

Penunjuk opsional ke konteks yang disediakan driver callout. Fungsi pemberitahuan peristiwa meneruskan parameter ini kembali ke driver.

flags

Dicadangkan. Atur ke nol.

reserved

Dicadangkan. Atur ke nol.

eventDispatchTable

Penunjuk ke struktur FWPS_VSWITCH_EVENT_DISPATCH_TABLE yang menentukan titik masuk panggilan balik untuk peristiwa lapisan sakelar virtual.

subscriptionId

Penunjuk ke variabel yang berisi pengidentifikasi unik yang ditetapkan WFP ke langganan. Pemanggil harus mengembalikan pengidentifikasi langganan ke WFP dengan fungsi FwpsvSwitchEventsUnsubscribe0 .

Mengembalikan nilai

Fungsi FwpsvSwitchEventsSubscribe0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Handel ke permintaan klasifikasi berhasil dikembalikan. Variabel yang dirujuk parameter classifyHandle berisi handel untuk permintaan klasifikasi.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Driver callout memanggil fungsi FwpsvSwitchEventsSubscribe0 untuk mendaftarkan titik masuk panggilan balik untuk peristiwa lapisan sakelar virtual.

Titik masuk untuk fungsi pemberitahuan panggilan balik ditentukan dalam struktur dan FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 .

Driver callout nantinya harus memanggil FwpsvSwitchEventsUnsubscribe0 untuk membebaskan sumber daya sistem.

Persyaratan

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

Lihat juga

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0

Share via