FWPS_FILTER1結構 (fwpstypes.h)
FWPS_FILTER1結構會在篩選引擎中定義運行時間篩選。 FWPS_FILTER0可供 使用。
語法
typedef struct FWPS_FILTER1_ {
UINT64 filterId;
FWP_VALUE0 weight;
UINT16 subLayerWeight;
UINT16 flags;
UINT32 numFilterConditions;
FWPS_FILTER_CONDITION0 *filterCondition;
FWPS_ACTION0 action;
UINT64 context;
FWPM_PROVIDER_CONTEXT1 *providerContext;
} FWPS_FILTER1;
成員
filterId
識別篩選引擎中篩選條件的運行時間標識碼。
weight
FWP_VALUE0 結構,其中包含值,指定篩選條件相對於篩選引擎中其他篩選的重要性。 系統會先叫用具有較高 權數 值的篩選。 FWP_VALUE0 結構中指定的數據類型是FWP_UINT64或FWP_EMPTY。 如果 FWP_VALUE0 結構中指定的數據類型是FWP_EMPTY,篩選引擎就會根據篩選引擎中其他篩選條件的特定程度,自動將加權指派給篩選條件。
subLayerWeight
值,指定篩選子圖層相對於篩選引擎中其他子圖層的重要性。 系統會先叫用位於具有較高 subLayerWeight 值的子圖層中的篩選。
flags
旗標,指定圖說文字 分類Fn1 圖說文字函式在處理網路數據時應該採取的動作。 可能的旗標包括:
值 | 意義 |
---|---|
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
與篩選相關聯的內容值。 圖說文字可以在將篩選新增至篩選引擎時,從圖說文字驅動程式的 notifyFn1 圖說文字函式內,將這個成員設定為指向圖說文字驅動程式提供的內容結構。 此內容結構對篩選引擎而言不透明,可由圖說文字驅動程式 的 classifyFn1 圖說文字函式使用,以保留篩選引擎對圖說文字驅動程式 之 classifyFn1 圖說文字函式呼叫之間的任何驅動程式特定數據或狀態資訊。
providerContext
提供者內容的指標,其格式為 FWPM_PROVIDER_CONTEXT1 結構。 如果篩選條件使用圖說文字,而且圖說文字已設定FWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT旗標,則此成員會包含對應 FWPM_FILTER0 結構的提供者內容。 否則,此參數為 NULL。
備註
篩選引擎會將 指標傳遞給圖 說文字的 notifyFn1 和 分類Fn1 圖說文字函式FWPS_FILTER1結構。
只有在篩選條件的所有篩選條件都成立時,才會執行篩選條件的動作。 如果未在篩選中指定篩選條件,則一律會執行指定的動作。
ProviderContext 成員會提供一種機制,讓圖說文字驅動程式在不呼叫基底篩選引擎 (BFE) 的情況下擷取提供者內容。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 7 開始提供。 |
標頭 | fwpstypes.h (包含 Fwpsk.h) |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應