共用方式為


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

圖說文字驅動程式指定此旗標,以指出圖說文字驅動程式的 分類Fn0 圖說文字函式不會受到卸載網路數據處理至可卸除的網路介面卡 (NIC) 所影響。 如果未指定此旗標,則會針對指定篩選動作註標的所有流量停用網路數據處理卸除。

classifyFn

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

notifyFn

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

flowDeleteFn

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

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

言論

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

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

要求

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

另請參閱

FWPS_CALLOUT1

FWPS_CALLOUT2

FwpsCalloutRegister0

分類Fn0

flowDeleteFn

notifyFn0