FWPS_CALLOUT1結構 (fwpsk.h)

FWPS_CALLOUT1 結構會定義圖說文字驅動程式向篩選引擎註冊圖說文字所需的數據。

附註FWPS_CALLOUT1 是 Windows 7 和更新版本中使用的特定 FWPS_CALLOUT 版本。 如需詳細資訊,請參閱 糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。 針對 Windows 8,FWPS_CALLOUT2 可供使用。 針對 Windows Vista,FWPS_CALLOUT0 可供使用。
 

語法

typedef struct FWPS_CALLOUT1_ {
  GUID                                calloutKey;
  UINT32                              flags;
  FWPS_CALLOUT_CLASSIFY_FN1           classifyFn;
  FWPS_CALLOUT_NOTIFY_FN1             notifyFn;
  FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT1;

成員

calloutKey

可唯一識別圖說文字的圖說文字驅動程式定義 GUID

flags

指定圖說文字特定參數的旗標。 可能的旗標為:

價值 意義
FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW
0x00000001
在註冊將在支持數據流的圖層新增圖說文字時,圖說驅動程式可以指定此旗標。 如果指定此旗標,篩選引擎只會在有與數據流相關聯的內容時,呼叫圖說文字驅動程式的 分類Fn1 圖說函式。 圖說文字驅動程式會藉由呼叫 FwpsFlowAssociateContext0 函式,將內容與數據流產生關聯。
FWP_CALLOUT_FLAG_ALLOW_OFFLOAD
0x00000002
圖說文字驅動程式會指定此旗標,以指出圖說文字驅動程式的 分類Fn1 圖說函式不會受到卸除網路數據處理以卸除功能網路適配器 (NIC) 所影響。 如果未指定此旗標,則會針對指定篩選動作註標的所有流量停用網路數據處理卸除。
FWP_CALLOUT_FLAG_ENABLE_COMMIT_ADD_NOTIFY
0x00000004
圖說文字驅動程式指定此旗標,指出它可以接收交易內新增之對象和篩選的相關通知。 篩選引擎會在認可交易之後傳送通知。
FWP_CALLOUT_FLAG_ALLOW_MID_STREAM_INSPECTION
0x00000008
圖說文字驅動程式會指定此旗標,指出它可以在數據流層級執行數據流的動態數據流檢查。 請參閱 資料流檢查
FWP_CALLOUT_FLAG_ALLOW_RECLASSIFY
0x00000010
圖說文字驅動程式會指定這個旗標,以在重新分類現有的套接字作業時註冊自己。

classifyFn

圖說文字驅動程式 分類Fn1 圖說函式的指標。 每當圖說文字要處理網路數據時,篩選引擎就會呼叫此函式。

notifyFn

圖說文字驅動程式 通知Fn1 函式的指標。 篩選引擎會呼叫此函式,以通知圖說文字驅動程式與圖說文字相關聯的事件。

flowDeleteFn

圖說文字驅動程式 flowDeleteFn 圖說函式的指標。 每當圖說文字所處理的數據流終止時,篩選引擎就會呼叫此函式。

如果圖說文字驅動程式未將內容與圖說文字處理的數據流產生關聯,則此成員應設定為 NULL

言論

圖說文字驅動程式會在向篩選引擎註冊圖說文字時,將指標傳遞至初始化的 FWPS_CALLOUT1 結構至 FwpsCalloutRegister1 函式。

圖說文字只能針對驅動程式有興趣執行串流檢查的連線設定 FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW 旗標。 所有其他連線上都會忽略此圖說文字。 效能將會改善,而且驅動程式不需要維護不必要的狀態數據。

此結構基本上與舊版相同,FWPS_CALLOUT0。 唯一的差異在於,此版本的成員會儲存註標函式指標的更新版本,而其他旗標可供圖說驅動程序設定。

要求

要求 價值
最低支援的用戶端 從 Windows 7 開始提供。
標頭 fwpsk.h (包括 Fwpsk.h)

另請參閱

FWPS_CALLOUT0

FWPS_CALLOUT2

FwpsCalloutRegister1

分類Fn1

flowDeleteFn

notifyFn1