Fungsi FwpsPendClassify0 (fwpsk.h)

Artikel
08/07/2023

Fungsi classifyFn callout memanggil FwpsPendClassify0 untuk menunggu permintaan klasifikasi saat ini. Setelah permintaan tertunda, driver callout harus menyelesaikan pemrosesan permintaan klasifikasi secara asinkron dengan memanggil FwpsCompleteClassify0.

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

Sintaks

NTSTATUS FwpsPendClassify0(
  [in]      UINT64             classifyHandle,
  [in]      UINT64             filterId,
  [in]      UINT32             flags,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);

Parameter

[in] classifyHandle

Handel klasifikasi yang mengidentifikasi pemrosesan driver callout pada lapisan saat ini. Handel ini diperoleh dengan memanggil FwpsAcquireClassifyHandle0.

[in] filterId

Nilai anggota FilterId dari parameter filter fungsi classifyFn. Untuk informasi selengkapnya tentang anggota FilterId , lihat FWPS_FILTER1.

[in] flags

Disiapkan untuk penggunaan masa mendatang. Atur ke nol.

[in, out] classifyOut

Atur ke parameter classifyOut dari fungsi classifyFn driver callout. Parameter classifyOut dari classifyFn terdaftar sebagai parameter output di header, tetapi berisi informasi yang cukup tentang input agar berguna bagi mesin ketika diteruskan ke FwpsPendClassify.

Nilai kembali

Fungsi FwpsPendClassify0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Permintaan klasifikasi berhasil ditunda.
STATUS_FWP_CANNOT_PEND	Mesin tidak mengizinkan klasifikasi asinkron pada lapisan tempat panggilan dilakukan.
Kode status lainnya	Terjadi kesalahan.

Keterangan

FwpsPendClassify0 menempatkan klasifikasi peristiwa yang ditunjukkan dalam keadaan tertunda. Driver callout biasanya menunggu klasifikasi sehingga lebih banyak pemrosesan dapat dilakukan di luar cakupan fungsi callout classifyFn . Driver callout kemudian dapat meneruskan handel klasifikasi dan data terkait lainnya tentang indikasi ke fungsi dengan dampak lebih sedikit pada performa daripada fungsi callout driver. Saat pemrosesan selesai, callout harus memanggil FwpsCompleteClassify0 untuk menghapus status tertunda. Pada saat panggilan ke FwpsCompleteClassify, driver callout harus mengembalikan struktur FWPS_CLASSIFY_OUT0 yang terisi seperti halnya dalam klasifikasi sebaris.

FwpsPendClassify0 meningkatkan jumlah referensi untuk handel klasifikasi yang diteruskan dalam parameter classifyHandle . Setelah driver callout memanggil fungsi ini, ia dapat memanggil FwpsReleaseClassifyHandle0 untuk merilis instans lokal. Ketika FwpsCompleteClassify0 dipanggil, referensi ke handel akan dikurangi secara otomatis.

Persyaratan

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