FWPS_CALLOUT0結構 (fwpsk.h)

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

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

語法

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

圖說文字驅動程式會指定此旗標,以指出圖說文字驅動程式 的 classifyFn0 圖說文字函式不受影響,方法是卸載網路資料處理,以卸載可用的網路介面卡, (NIC) 。 如果未指定此旗標,則會針對指定篩選動作圖說文字的所有流量停用網路資料處理的卸載。

classifyFn

圖說文字驅動程式 之 classifyFn0 圖說文字函式的指標。 每當圖說文字要處理網路資料時,篩選引擎就會呼叫此函式。

notifyFn

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

flowDeleteFn

圖說文字驅動程式 流程的指標DeleteFn 圖說文字函式。 每當圖說文字正在處理的資料流程終止時,篩選引擎就會呼叫此函式。

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

備註

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

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

必要條件

   
最低支援的用戶端 從 Windows Vista 開始提供。
標頭 fwpsk.h (包含 Fwpsk.h)

另請參閱

FWPS_CALLOUT1

FWPS_CALLOUT2

FwpsCalloutRegister0

classifyFn0

flowDeleteFn

notifyFn0