共用方式為

FWPS_CALLOUT3結構 （fwpsk.h）

  • 發行項

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

語法

typedef struct FWPS_CALLOUT3_ {
  GUID                                calloutKey;
  UINT32                              flags;
  FWPS_CALLOUT_CLASSIFY_FN3           classifyFn;
  FWPS_CALLOUT_NOTIFY_FN3             notifyFn;
  FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT3;

成員

calloutKey

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

flags

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

價值 意義
FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW
0x00000001		 在註冊將在支持數據流的圖層新增圖說文字時，圖說驅動程式可以指定此旗標。 如果指定此旗標，篩選引擎只會在數據流有相關聯的內容時，呼叫圖說文字驅動程式的 分類Fn3 圖說文字函式。 圖說文字驅動程式會藉由呼叫 FwpsFlowAssociateContext0 函式，將內容與數據流產生關聯。
FWP_CALLOUT_FLAG_ALLOW_OFFLOAD
0x00000002		 圖說文字驅動程式會指定此旗標，以指出圖說文字驅動程式的 分類Fn3 圖說函式不受卸載網路數據處理以卸除功能網路適配器 （NIC） 所影響。 如果未指定此旗標，則會針對指定篩選動作註標的所有流量停用網路數據處理卸除。
FWP_CALLOUT_FLAG_ENABLE_COMMIT_ADD_NOTIFY
0x00000004		 圖說文字驅動程式指定此旗標，指出它可以接收交易內新增之對象和篩選的相關通知。 篩選引擎會在認可交易之後傳送通知。
FWP_CALLOUT_FLAG_ALLOW_MID_STREAM_INSPECTION
0x00000008		 圖說文字驅動程式會指定此旗標，指出它可以在數據流層級執行數據流的動態數據流檢查。 請參閱 資料流檢查。
FWP_CALLOUT_FLAG_ALLOW_RECLASSIFY
0x00000010		 圖說文字驅動程式會指定這個旗標，以在重新分類現有的套接字作業時註冊自己。
FWP_CALLOUT_FLAG_RESERVED1
0x00000020		 保留供系統使用。 圖說文字驅動程序應該忽略此旗標。
FWP_CALLOUT_FLAG_ALLOW_RSC
0x00000040		 圖說文字驅動程式會指定此旗標，指出圖說文字支援 TCP 接收區段聯合 （RSC），且封包最多為 64K。 如果未指定此旗標，而且已註冊圖說文字，則所有由指定篩選動作圖說文字的篩選條件所處理的所有流量都會停用 RSC。
FWP_CALLOUT_FLAG_ALLOW_L2_BATCH_CLASSIFY
0x00000080		 圖說文字驅動程式會在註冊將在第 2 層新增的圖說文字時指定此旗標，以指出其 分類Fn3 圖說函式可以分類多個鏈結 NET_BUFFER_LIST 結構。 如需詳細資訊，請參閱 使用第 2 層篩選。

注意：
如果圖說文字驅動程式設定此旗標，就無法使用下列函式來修改NET_BUFFER_LISTs。

• FwpsReferenceNetBufferList0
• FwpsDereferenceNetBufferList0
• FwpsAllocateCloneNetBufferList0
• FwpsFreeCloneNetBufferList0

設定此旗標后，FwpsAllocateCloneNetBufferList0 一律會傳回 INVALID_PARAMETER 錯誤。 這可能會導致第三方圖說驅動程式無法管理NET_BUFFER_LISTs的參考計數，導致傳送和接收作業停止。
FWP_CALLOUT_FLAG_ALLOW_USO
0x00000100		 圖說文字驅動程式指定此旗標，指出圖說文字支援 UDP 分割卸除 （USO），其封包大於網路媒體 MTU。 如果未指定此旗標，並註冊圖說文字，則所有由指定篩選動作圖說文字的篩選條件所處理的流量都會停用 USO。 注意： 支援此旗標的最早版本是 Windows Insider Preview 版本 10.0.25876。
FWP_CALLOUT_FLAG_ALLOW_URO
0x00000200		 圖說驅動程式指定此旗標，指出圖說文字支援 UDP 接收卸除 （URO），且大型封包高達 64K。 如果未指定此旗標並註冊圖說文字，則會針對任何指定篩選動作圖說文字的篩選所處理的流量停用 URO。 注意： 如果指定此旗標，則圖說文字不得複製並重新套用輸入URO封包。

classifyFn

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

notifyFn

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

flowDeleteFn

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

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

言論

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

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

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

FWPS_CALLOUT3 是 FWPS_CALLOUT的特定版本。 如需詳細資訊，請參閱 糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
標頭 fwpsk.h

另請參閱