FWPS_CALLOUT0結構 (fwpsk.h)
FWPS_CALLOUT0 結構會定義圖說文字驅動程式向篩選引擎註冊圖說文字所需的數據。
語法
typedef struct FWPS_CALLOUT0_ {
GUID calloutKey;
UINT32 flags;
FWPS_CALLOUT_CLASSIFY_FN0 classifyFn;
FWPS_CALLOUT_NOTIFY_FN0 notifyFn;
FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT0;
成員
calloutKey
可唯一識別圖說文字的圖說文字驅動程式定義 GUID。
flags
指定圖說文字特定參數的旗標。 可能的旗標為:
FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW
在註冊將在支持數據流的圖層新增圖說文字時,圖說驅動程式可以指定此旗標。 如果指定此旗標,篩選引擎只會在數據流有相關聯的內容時,呼叫圖說文字驅動程式的 classifyFn0 圖說文字函式。 圖說文字驅動程式會藉由呼叫 FwpsFlowAssociateContext0 函式,將內容與數據流產生關聯。
FWP_CALLOUT_FLAG_ALLOW_OFFLOAD
圖說文字驅動程式指定此旗標,以指出圖說文字驅動程式的 分類Fn0 圖說文字函式不會受到卸載網路數據處理至可卸除的網路介面卡 (NIC) 所影響。 如果未指定此旗標,則會針對指定篩選動作註標的所有流量停用網路數據處理卸除。
classifyFn
圖說文字驅動程式 分類Fn0 圖說函式的指標。 每當圖說文字要處理網路數據時,篩選引擎就會呼叫此函式。
notifyFn
圖說文字驅動程式 notifyFn0 函式的指標。 篩選引擎會呼叫此函式,以通知圖說文字驅動程式與圖說文字相關聯的事件。
flowDeleteFn
圖說文字驅動程式 flowDeleteFn 圖說函式的指標。 每當圖說文字所處理的數據流終止時,篩選引擎就會呼叫此函式。
如果圖說文字驅動程式未將內容與圖說文字處理的數據流產生關聯,則此成員應設定為 NULL。
言論
圖說文字驅動程式會在向篩選引擎註冊圖說文字時,將指標傳遞給 FwpsCalloutRegister0 函式的初始化 FWPS_CALLOUT0 結構。
圖說文字只能針對驅動程式有興趣執行串流檢查的連線設定 FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW 旗標。 所有其他連線上都會忽略此圖說文字。 效能將會改善,而且驅動程式不需要維護不必要的狀態數據。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows Vista 開始提供。 |
標頭 | fwpsk.h (包括 Fwpsk.h) |