FWPS_CALLOUT1 結構 (fwpsk.h)

發行項
02/29/2024

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	圖說文字驅動程式可以在註冊將在支持數據流的圖層新增的圖說文字時指定此旗標。如果指定此旗標，篩選引擎只會呼叫圖說文字驅動程式的classifyFn1 圖說文字函式，只有當數據流有相關聯的內容時。圖說文字驅動程式會藉由呼叫 FwpsFlowAssociateContext0 函式，將內容與數據流產生關聯。
FWP_CALLOUT_FLAG_ALLOW_OFFLOAD 0x00000002	圖說文字驅動程式會指定此旗標，以指出圖說文字驅動程式的 classifyFn1 圖說文字函式不會受到卸載網路數據處理，以卸除功能網路適配器 (NIC) 。如果未指定此旗標，則會針對指定篩選動作之圖說文字的所有流量停用網路數據處理的卸除。
FWP_CALLOUT_FLAG_ENABLE_COMMIT_ADD_NOTIFY 0x00000004	圖說文字驅動程式會指定此旗標，指出它可以接收交易內新增之對象和篩選的通知。篩選引擎會在認可交易之後傳送通知。
FWP_CALLOUT_FLAG_ALLOW_MID_STREAM_INSPECTION 0x00000008	圖說文字驅動程式會指定此旗標，指出它可以在數據流層級執行數據流的動態數據流檢查。請參閱 Stream 檢查。
FWP_CALLOUT_FLAG_ALLOW_RECLASSIFY 0x00000010	圖說文字驅動程式會指定此旗標，以在重新分類現有套接字作業時註冊要呼叫的本身。