FWPS_CALLOUT_CLASSIFY_FN3回呼函式 （fwpsk.h）

  • 發行項

圖說文字篩選器相符時，分類期間叫用的第 3 版回呼函式。 這個回呼傳回 FWPS_FILTER3 結構的差異。

語法

FWPS_CALLOUT_CLASSIFY_FN3 FwpsCalloutClassifyFn3;

void FwpsCalloutClassifyFn3(
  const FWPS_INCOMING_VALUES0 *inFixedValues,
  const FWPS_INCOMING_METADATA_VALUES0 *inMetaValues,
  void *layerData,
  const void *classifyContext,
  const FWPS_FILTER3 *filter,
  UINT64 flowContext,
  FWPS_CLASSIFY_OUT0 *classifyOut
)
{...}

參數

inFixedValues

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

inMetaValues

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

layerData

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

classifyContext

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

filter

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

flowContext

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

classifyOut

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

傳回值

沒有

言論

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

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

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

  • 當 分類Fn1 圖說函式將 FWPS_CLASSIFY_OUT0 結構的 actionType 成員設定為 FWP_ACTION_BLOCK。
  • 當 分類Fn1 圖說函式將 FWPS_CLASSIFY_OUT0 結構的 actionType 成員設定為 FWP_ACTION_PERMIT，且 FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT 旗標是在 FWPS_FILTER3 結構的 flags 成員中設定。
  • 當圖說文字指出它打算修改複製 net 緩衝區清單時，請將 intendToModify 參數設定為在呼叫 FwpsReferenceNetBufferList0 函式時 ，將 TRUE 設定為 true。

要求

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

另請參閱