Fungsi FwpsPendClassify0 (fwpsk.h)

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.

Mengembalikan nilai

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 menambahkan 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

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

Lihat juga

FWPS_CLASSIFY_OUT0

FWPS_FILTER1

FwpsAcquireClassifyHandle0

FwpsCompleteClassify0

FwpsReleaseClassifyHandle0

classifyFn