Fungsi FwpmBfeStateSubscribeChanges0 (fwpmk.h)

Artikel
03/08/2023

Fungsi FwpmBfeStateSubscribeChanges0 mendaftarkan fungsi panggilan balik yang dipanggil setiap kali ada perubahan pada status mesin filter.

CatatanFwpmBfeStateSubscribeChanges0 adalah versi tertentu dari FwpmBfeStateSubscribeChanges. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.

Peringatan

Jangan panggil FwpmBfeStateUnsubscribeChanges0 dari fungsi panggilan balik yang Anda lewati dalam parameter panggilan balik . Melakukannya dapat menyebabkan kebuntuan.

Sintaks

NTSTATUS FwpmBfeStateSubscribeChanges0(
  [in, out]      void                                *deviceObject,
  [in]           FWPM_SERVICE_STATE_CHANGE_CALLBACK0 callback,
  [in, optional] void                                *context,
  [out]          HANDLE                              *changeHandle
);

Parameter

[in, out] deviceObject

Penunjuk ke objek perangkat yang sebelumnya dibuat oleh driver callout. Untuk informasi selengkapnya tentang cara driver callout membuat objek perangkat, lihat Membuat Objek Perangkat.

[in] callback

Penunjuk ke fungsi panggilan balik perubahan status layanan yang disediakan driver callout. Mesin filter memanggil fungsi ini setiap kali ada perubahan status mesin filter.

Fungsi panggilan balik perubahan status layanan dinyatakan sebagai berikut.

VOID NTAPI
callback(
    IN OUT void  *context,
    IN FWPM_SERVICE_STATE  newState
    );

Konteks

Penunjuk yang diteruskan dalam parameter Konteks ketika driver callout memanggil fungsi FwpmBfeStateSubscribeChanges0 .

newState

Status baru mesin filter. Parameter ini berisi salah satu nilai berikut:

FWPM_SERVICE_STOPPED

Mesin filter tidak berjalan.

FWPM_SERVICE_START_PENDING

Mesin filter dimulai.

FWPM_SERVICE_STOP_PENDING

Mesin filter berhenti.

FWPM_SERVICE_RUNNING

Mesin filter sedang berjalan.

[in, optional] context

Penunjuk ke konteks yang disediakan driver callout yang diteruskan ke fungsi panggilan balik yang ditentukan dalam parameter Callback .

[out] changeHandle

Penunjuk ke variabel yang menerima handel yang terkait dengan pendaftaran fungsi panggilan balik. Driver callout meneruskan handel ini ke fungsi FwpmBfeStateUnsubscribeChanges0 untuk membatalkan pendaftaran fungsi panggilan balik.

Nilai kembali

Fungsi FwpmBfeStateSubscribeChanges0 mengembalikan salah satu kode NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi panggilan balik berhasil didaftarkan.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Driver callout memanggil fungsi FwpmBfeStateSubscribeChanges0 untuk mendaftarkan fungsi panggilan balik yang dipanggil setiap kali ada perubahan pada status mesin filter.

Misalnya, driver callout tidak dapat membuka sesi ke mesin filter dengan memanggil fungsi FwpmEngineOpen0 kecuali mesin filter saat ini berjalan. Driver callout dapat menggunakan pemberitahuan FWPM_SERVICE_RUNNING untuk membuka sesi ke mesin filter sehingga dapat melakukan panggilan ke fungsi manajemen Windows Filtering Platform lainnya. Demikian pula, driver callout dapat menggunakan pemberitahuan FWPM_SERVICE_STOP_PENDING untuk melakukan pembersihan sebelum mesin filter dihentikan.

Driver callout harus memanggil FwpmBfeStateSubscribeChanges0 sebelum memanggil fungsi FwpmBfeStateGet0 untuk mengambil status mesin filter saat ini. Setelah panggilan ke FwpmBfeStateSubscribeChanges0 kembali, driver callout dapat memanggil FwpmBfeStateGet0 kapan saja.

Driver callout harus membatalkan pendaftaran fungsi panggilan balik dengan memanggil Fungsi FwpmBfeStateUnsubscribeChanges0 sebelum driver callout dapat dibongkar.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows Vista.
Target Platform	Universal
Header	fwpmk.h (termasuk Fwpmk.h)
Pustaka	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

Lihat juga

FwpmBfeStateGet0

FwpmBfeStateUnsubscribeChanges0

FwpmEngineOpen0

Share via