FWPS_CALLOUT0結構 (fwpsk.h)

發行項
02/29/2024

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)

另請參閱

FwpsCalloutRegister0