FWPS_FILTER0 結構 (fwpstypes.h)

發行項
02/29/2024

FWPS_FILTER0結構會在篩選引擎中定義運行時間篩選。 FWPS_FILTER2 可供使用。針對 Windows 7，FWPS_FILTER1 可供使用。

語法

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;

成員

filterId

運行時間標識碼，識別篩選引擎中的篩選。

weight

FWP_VALUE0 結構，其中包含值，指定篩選與篩選引擎中其他篩選條件相關的篩選重要性。系統會先叫用具有較高權數值的篩選。 FWP_VALUE0 結構中指定的數據類型為FWP_UINT64或FWP_EMPTY。如果 FWP_VALUE0 結構中指定的數據類型是FWP_EMPTY，篩選引擎就會根據篩選引擎中其他篩選條件的特定程度，自動將加權指派給篩選。

subLayerWeight

值，指定篩選子圖層相對於篩選引擎中其他子圖層的重要性。系統會先叫用位於具有較高 subLayerWeight 值的子 圖層中的篩選。

flags

旗標，指定圖說文字分類Fn0 圖說文字函式在處理網路數據時應該採取的動作。可能的旗標包括：

值	意義
FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT	這個旗標會向圖說文字的 classifyFn0 圖說文字函式指出，當它傳回建議動作的FWP_ACTION_BLOCK或FWP_ACTION_PERMIT時，它應該一律清除FWPS_RIGHT_ACTION_WRITE旗標。如果未設定此旗標，圖說文字的 classifyFn0 圖說文字函式應該只會在傳回建議動作的FWP_ACTION_BLOCK時清除FWPS_RIGHT_ACTION_WRITE旗標。
FWPS_FILTER_FLAG_PERMIT_IF_CALLOUT_UNREGISTERED	這個旗標會向圖說文字的 classifyFn0 圖說文字函式指出，如果未註冊圖說文字，則圖說文字應該視為允許篩選條件。

numFilterConditions

filterCondition 成員所指向之陣列中的FWPS_FILTER_CONDITION0結構數目。這個成員可以是零。

filterCondition

FWPS_FILTER_CONDITION0 結構的陣列指標。這些結構會定義篩選條件的運行時間篩選條件。如果 numFilterConditions 成員為零，則此指標會是 NULL。

action

FWPS_ACTION0 結構，指定篩選條件為 true 時，篩選條件應該採取的動作。

context

與篩選相關聯的內容值。圖說文字可以在將篩選新增至篩選引擎時，從圖說文字驅動程式的 notifyFn0 圖說文字函式內指向圖說文字驅動程式提供的內容結構。此內容結構對篩選引擎而言不透明，可由圖說文字驅動程式的 classifyFn0 圖說文字函式使用，以保留篩選引擎對圖說驅動程式 分類Fn0 圖說文字函式呼叫之間的任何驅動程式特定數據或狀態資訊。

providerContext

提供者內容的指標，其格式為 FWPM_PROVIDER_CONTEXT0 結構。如果篩選使用圖說文字，而且圖說文字已設定FWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT旗標，則此成員會包含對應 FWPM_FILTER0 結構的提供者內容。否則，此參數為 NULL。