FWPS_CALLOUT_CLASSIFY_FN2回呼函式（fwpsk.h）

發行項
02/06/2025

每當圖說文字處理數據時，篩選引擎會呼叫圖說文字 分類Fn2 圖說函式。

NoteclassifyFn2 是 Windows 8 和更新版本中使用的特定分類Fn 版本。如需詳細資訊，請參閱糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。針對 Windows 7，分類Fn1 可供使用。針對 Windows Vista，分類Fn0 可供使用。

語法

FWPS_CALLOUT_CLASSIFY_FN2 FwpsCalloutClassifyFn2;

void FwpsCalloutClassifyFn2(
  [in]                const FWPS_INCOMING_VALUES0 *inFixedValues,
  [in]                const FWPS_INCOMING_METADATA_VALUES0 *inMetaValues,
  [in, out, optional] void *layerData,
  [in, optional]      const void *classifyContext,
  [in]                const FWPS_FILTER2 *filter,
  [in]                UINT64 flowContext,
  [in, out]           FWPS_CLASSIFY_OUT0 *classifyOut
)
{...}

參數

[in] inFixedValues

FWPS_INCOMING_VALUES0 結構的指標。此結構包含所篩選之圖層中每個數據欄位的值。

[in] inMetaValues

的指標 FWPS_INCOMING_METADATA_VALUES0 結構。此結構包含所篩選之圖層中每個元數據欄位的值。

[in, out, optional] layerData

結構的指標，描述正在篩選之圖層中的原始數據。此參數可能是 NULL，視要篩選的圖層和呼叫 分類Fn2 圖說函式的條件而定。對於數據流層，此參數會指向 FWPS_STREAM_CALLOUT_IO_PACKET0 結構。對於所有其他圖層，如果不是 NULL，此參數會指向 NET_BUFFER_LIST 結構。

[in, optional] classifyContext

篩選引擎與圖說文字驅動程式相關聯的內容數據的指標。

[in] filter

FWPS_FILTER2 結構的指標。此結構描述指定篩選動作圖說文字的篩選條件。

[in] flowContext

UINT64 型別變數，其中包含與數據流相關聯的內容。如果沒有與數據流相關聯的內容，則此參數為零。如果圖說文字新增至篩選引擎的篩選層不支持數據流，分類Fn2 圖說函式應該忽略此參數。

[in, out] classifyOut

FWPS_CLASSIFY_OUT0 結構的指標，接收 分類Fn2 圖說函式傳回給呼叫端的任何數據。

傳回值

沒有

言論

圖說文字驅動程式會藉由呼叫 FwpsCalloutRegister2 函式，向篩選引擎註冊圖說文字函式。

篩選引擎會呼叫圖說文字的 分類Fn2 圖說函式，並在篩選引擎中指定篩選動作圖說文字的篩選條件為 true 時，處理數據。

圖說文字的 分類Fn2 圖說函式，在下列任一情況下，應清除 FWPS_CLASSIFY_OUT0 結構 許可權 成員中的FWPS_RIGHT_ACTION_WRITE旗標：

當 分類Fn2 圖說函式將 FWPS_CLASSIFY_OUT0 結構成員 actionType 設定為FWP_ACTION_BLOCK。
當分類Fn2 圖說函式 將 FWPS_CLASSIFY_OUT0 結構的 actionType 成員設定為FWP_ACTION_PERMIT，且FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT旗標是在 FWPS_FILTER2 結構的旗標成員中設定。
當圖說文字指出它打算修改複製 net 緩衝區清單時，請將 intendToModify 參數設定為 TRUE，以呼叫 FwpsReferenceNetBufferList0 函式。
此函式基本上與舊版相同，classifyFn1。不過，篩選參數指向更新的 FWPS_FILTER2 結構，而 layerData 參數是選擇性的。