struktur FWPS_FILTER2 (fwpstypes.h)

Artikel
05/03/2024

Menentukan filter run-time di mesin filter. FWPS_FILTER0 tersedia.

Sintaks

typedef struct FWPS_FILTER2_ {
  UINT64                 filterId;
  FWP_VALUE0             weight;
  UINT16                 subLayerWeight;
  UINT16                 flags;
  UINT32                 numFilterConditions;
  FWPS_FILTER_CONDITION0 *filterCondition;
  FWPS_ACTION0           action;
  UINT64                 context;
  FWPM_PROVIDER_CONTEXT2 *providerContext;
} FWPS_FILTER2;

Anggota

filterId

Pengidentifikasi run-time yang mengidentifikasi filter di mesin filter.

weight

Struktur FWP_VALUE0 yang berisi nilai yang menentukan kepentingan filter dalam kaitannya dengan filter lain di mesin filter. Filter dengan nilai bobot yang lebih tinggi dipanggil terlebih dahulu. Jenis data yang ditentukan dalam struktur FWP_VALUE0FWP_UINT64 atau FWP_EMPTY. Jika jenis data yang ditentukan dalam struktur FWP_VALUE0 FWP_EMPTY, mesin filter secara otomatis menetapkan bobot ke filter berdasarkan seberapa spesifik filter menguji data dibandingkan dengan filter lain di mesin filter.

subLayerWeight

Nilai yang menentukan pentingnya sublayer filter sehubungan dengan sublayer lain di mesin filter. Filter yang terletak di sublayer dengan nilai subLayerWeight yang lebih tinggi dipanggil terlebih dahulu.

flags

Bendera yang menentukan tindakan yang harus diambil oleh fungsi callout classifyFn2 callout saat memproses data jaringan. Bendera yang mungkin adalah:

Nilai	Makna
FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT	Bendera ini menunjukkan ke fungsi callout classifyFn0 callout bahwa ia harus selalu menghapus bendera FWPS_RIGHT_ACTION_WRITE saat mengembalikan FWP_ACTION_BLOCK atau FWP_ACTION_PERMIT untuk tindakan yang disarankan. Jika bendera ini tidak diatur, fungsi callout classifyFn0 callout hanya boleh menghapus bendera FWPS_RIGHT_ACTION_WRITE saat mengembalikan FWP_ACTION_BLOCK untuk tindakan yang disarankan.
FWPS_FILTER_FLAG_PERMIT_IF_CALLOUT_UNREGISTERED	Bendera ini menunjukkan ke fungsi callout classifyFn0 callout bahwa jika callout tidak terdaftar, callout harus diperlakukan sebagai filter izin.

Nilai

Makna

FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT

Bendera ini menunjukkan ke fungsi callout classifyFn0 callout bahwa ia harus selalu menghapus bendera FWPS_RIGHT_ACTION_WRITE saat mengembalikan FWP_ACTION_BLOCK atau FWP_ACTION_PERMIT untuk tindakan yang disarankan. Jika bendera ini tidak diatur, fungsi callout classifyFn0 callout hanya boleh menghapus bendera FWPS_RIGHT_ACTION_WRITE saat mengembalikan FWP_ACTION_BLOCK untuk tindakan yang disarankan.

FWPS_FILTER_FLAG_PERMIT_IF_CALLOUT_UNREGISTERED

Bendera ini menunjukkan ke fungsi callout classifyFn0 callout bahwa jika callout tidak terdaftar, callout harus diperlakukan sebagai filter izin.

numFilterConditions

Jumlah struktur FWPS_FILTER_CONDITION0 dalam array yang ditujukan oleh anggota filterCondition . Anggota ini bisa nol.

filterCondition

Penunjuk ke array struktur FWPS_FILTER_CONDITION0 . Struktur ini menentukan kondisi pemfilteran run-time untuk filter. Jika anggota numFilterConditions adalah nol, maka pointer ini akan menjadi NULL.

action

Struktur FWPS_ACTION0 yang menentukan tindakan yang harus diambil filter jika semua kondisi pemfilteran filter benar.

context

Nilai konteks yang terkait dengan filter. Callout dapat mengatur anggota ini untuk menunjuk ke struktur konteks callout yang disediakan driver dari dalam fungsi callout driver calloutFn2 saat filter ditambahkan ke mesin filter. Struktur konteks ini, yang buram ke mesin filter, dapat digunakan oleh fungsi callout classifyFn2 driver callout untuk mempertahankan data khusus driver atau informasi status antara panggilan oleh mesin filter ke fungsi callout driver calloutFn2 .

providerContext

Penunjuk ke konteks penyedia, yang diformat sebagai struktur FWPM_PROVIDER_CONTEXT2 . Jika filter menggunakan callout, dan callout memiliki bendera FWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT yang ditetapkan, anggota ini akan berisi konteks penyedia dari struktur FWPM_FILTER0 yang sesuai. Jika tidak, parameter ini adalah NULL.

Keterangan

Mesin filter meneruskan penunjuk ke struktur FWPS_FILTER2 ke fungsi callout notifyFn2 dan classifyFn2 .

Tindakan filter dilakukan hanya jika semua kondisi pemfilteran filter benar. Jika tidak ada kondisi pemfilteran yang ditentukan dalam filter, tindakan yang ditentukan selalu dilakukan.

Anggota providerContext menyediakan mekanisme bagi driver callout untuk mengambil konteks penyedia tanpa memanggil mesin pemfilteran dasar (BFE).

Struktur ini pada dasarnya identik dengan versi sebelumnya, FWPM_PROVIDER_CONTEXT2 struktur di anggota providerContext .