共用方式為

FwpsCalloutRegister3 函式 （fwpsk.h）

  • 發行項

FwpsCalloutRegister3 函式會註冊 FWPS_CALLOUT3 結構第 3 版的函式指標。

語法

NTSTATUS FwpsCalloutRegister3(
  [in, out]       void                *deviceObject,
  [in]            const FWPS_CALLOUT3 *callout,
  [out, optional] UINT32              *calloutId
);

參數

[in, out] deviceObject

圖說文字驅動程式先前建立之裝置物件的指標。 如需圖說文字驅動程式如何建立裝置物件的詳細資訊，請參閱 建立裝置物件。

[in] callout

常數 FWPS_CALLOUT3 結構的指標，其中包含向篩選引擎註冊圖說文字所需的數據。

[out, optional] calloutId

UINT32 型別變數的指標，可接收識別篩選引擎中註標的運行時間標識碼。 圖說文字驅動程式會在從篩選引擎取消註冊圖說文字時，將此標識碼傳遞至 FwpsCalloutUnregisterById0 函式。 如果圖說驅動程式正在篩選數據流，它也會將此標識符傳遞至 FwpsFlowAssociateContext0，並 FwpsFlowRemoveContext0 函式。 如果圖說驅動程式將數據插入數據流中，它也會將此標識符傳遞至 FwpsStreamInjectAsync0 函式 。 篩選引擎也會將此標識符傳遞至圖說文字驅動程式的 FwpsCalloutFlowDeleteNotifyFn0 圖說文字函式。 這個參數是選擇性的，而且可以 NULL。

傳回值

FwpsCalloutRegister3 函式會傳回下列其中一個 NTSTATUS 代碼。

傳回碼 描述
STATUS_SUCCESS 圖說文字已成功向篩選引擎註冊。
STATUS_FWP_ALREADY_EXISTS 無法向篩選引擎註冊圖說文字。 圖說文字已經在篩選引擎中註冊，其標識符與 圖說文字參數所 指向之 FWPS_CALLOUT3 結構 成員的 GUID 相同。
其他 NTSTATUS 代碼 發生錯誤。

言論

圖說文字驅動程式必須先呼叫 FwpsCalloutUnregisterById0，才能卸除。

圖說文字驅動程式會呼叫 FwpsCalloutRegister3 函式，向篩選引擎註冊圖說文字。 圖說文字驅動程式可以隨時向篩選引擎註冊圖說文字，即使篩選引擎目前未執行也一樣。

在圖說文字驅動程式向篩選引擎註冊圖說文字之前，可以將指定篩選動作圖說文字的圖說文字新增至篩選引擎。 在此情況下，會將動作類型為 FWP_ACTION_CALLOUT_TERMINATING 或 FWP_ACTION_CALLOUT_UNKNOWN 的篩選視為 FWP_ACTION_BLOCK，並忽略動作類型為 FWP_ACTION_CALLOUT_INSPECTION 的篩選條件，直到向篩選引擎註冊圖說文字為止。

圖說文字驅動程式會呼叫 FwpsCalloutUnregisterById0 函式或 FwpsCalloutUnregisterByKey0 函式，從篩選引擎取消註冊圖說文字。 除非先前向篩選引擎註冊的所有圖說文字已成功取消註冊，否則無法卸除圖說文字驅動程式。

此函式基本上與舊版相同，FwpsCalloutRegister2。 唯一的差異在於圖說參數所指向的更新 FWPS_CALLOUT3 結構。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 普遍
標頭 fwpsk.h
連結庫 Fwpkclnt.lib
IRQL PASSIVE_LEVEL

另請參閱