struktur FWPS_FILTER0 (fwpstypes.h)

Artikel
05/07/2024

Struktur FWPS_FILTER0 mendefinisikan filter run-time di mesin filter. FWPS_FILTER2 tersedia. Untuk Windows 7, FWPS_FILTER1 tersedia.

Sintaks

typedef struct FWPS_FILTER0_ {
  UINT64                 filterId;
  FWP_VALUE0             weight;
  UINT16                 subLayerWeight;
  UINT16                 flags;
  UINT32                 numFilterConditions;
  FWPS_FILTER_CONDITION0 *filterCondition;
  FWPS_ACTION0           action;
  UINT64                 context;
  FWPM_PROVIDER_CONTEXT0 *providerContext;
} FWPS_FILTER0;

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 classifyFn0 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.
FWPS_FILTER_FLAG_OR_CONDITIONS	Ada beberapa kondisi untuk bidang yang sama. `OR` semantik diterapkan.
FWPS_FILTER_FLAG_HAS_SECURITY_REALM_PROVIDER_CONTEXT	Filter mereferensikan konteks penyedia untuk id realm keamanan IPsec.
FWPS_FILTER_FLAG_SILENT_MODE	Filter dalam mode senyap.
FWPS_FILTER_FLAG_IPSEC_NO_ACQUIRE_INITIATE	Jangan memulai IPsec memperoleh jika paket cocok dengan kebijakan IPsec dari filter dengan bendera ini.
FWPS_FILTER_FLAG_RESERVED0	Dicadangkan untuk penggunaan sistem.
FWPS_FILTER_FLAG_RESERVED1	Dicadangkan untuk penggunaan sistem.
FWPS_FILTER_FLAG_RESERVED2	Dicadangkan untuk penggunaan sistem.

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 calloutFn0 saat filter ditambahkan ke mesin filter. Struktur konteks ini, yang buram ke mesin filter, dapat digunakan oleh fungsi callout classifyFn0 driver callout untuk mempertahankan data khusus driver atau informasi status antara panggilan oleh mesin filter ke fungsi callout classifyFn0 driver callout.

providerContext

Penunjuk ke konteks penyedia, yang diformat sebagai struktur FWPM_PROVIDER_CONTEXT0 . 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 pointer ke struktur FWPS_FILTER0 ke fungsi callout callout notifyFn0 dan classifyFn0 .

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).