FWPS_CALLOUT_NOTIFY_FN1回呼函式 (fwpsk.h)

發行項
02/26/2024

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

注意notifyFn1 是 Windows 7 和更新版本中使用的特定 notifyFn 版本。如需詳細資訊，請參閱 Version-Independent 名稱和以特定版本的 Windows 為目標。如需 Windows 8，則會提供 notifyFn2。針對 Windows Vista，notifyFn0 可供使用。

語法

FWPS_CALLOUT_NOTIFY_FN1 FwpsCalloutNotifyFn1;

NTSTATUS FwpsCalloutNotifyFn1(
  [in] FWPS_CALLOUT_NOTIFY_TYPE notifyType,
  [in] const GUID *filterKey,
  [in] FWPS_FILTER1 *filter
)
{...}

參數

[in] notifyType

值，指出篩選引擎傳送至圖說文字的通知類型。這個參數的有效值為：

FWPS_CALLOUT_NOTIFY_ADD_FILTER

篩選正在新增至篩選引擎，以指定篩選動作的圖說文字。

FWPS_CALLOUT_NOTIFY_DELETE_FILTER

正在從篩選引擎中刪除篩選，指定篩選動作的圖說文字。

FWPS_CALLOUT_NOTIFY_TYPE_MAX

測試用途的最大值。

[in] filterKey

篩選條件的管理標識子指標，如新增或刪除篩選的應用程式或驅動程式所指定。如果 notifyType 參數設定為 FWPS_CALLOUT_NOTIFY_DELETE_FILTER，則必須為 NULL。如需詳細資訊，請參閱＜備註＞。

[in] filter

FWPS_FILTER1 結構的指標。此結構描述要加入或刪除篩選引擎的篩選。

圖說文字驅動程式的 notifyFn1 函式可以在將篩選新增至篩選引擎時，將這個結構的 Context 成員設定為指向圖說文字驅動程式提供的內容結構。此內容結構對篩選引擎不透明，而且可由圖說文字驅動程式的 classifyFn1 圖說文字函式使用，以保留篩選引擎對圖說驅動程式呼叫之間的任何驅動程式特定數據或狀態資訊
classifyFn1 圖說文字函式。

圖說文字驅動程式的 notifyFn1 函式可以在篩選引擎中刪除篩選時清除與篩選相關聯的任何內容。

傳回值

圖說文字的 notifyFn1 函式會傳回下列其中一個 NTSTATUS 代碼。

傳回碼	Description
STATUS_SUCCESS	圖說文字驅動程式會接受來自篩選引擎的通知。
其他狀態代碼	發生錯誤。如果 notifyType 參數FWPS_CALLOUT_NOTIFY_ADD_FILTER，則不會將篩選新增至篩選引擎。如果 notifyType 參數FWPS_CALLOUT_NOTIFY_DELETE_FILTER，篩選仍會從篩選引擎中刪除。

備註

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

篩選引擎會呼叫圖說驅動程式的 notifyFn1 函式，以通知圖說文字驅動程式與圖說文字相關聯的事件。如果圖說文字驅動程式的 notifyFn1 函式無法辨識在 notifyType 參數中傳遞的通知類型，它應該忽略通知並傳回STATUS_SUCCESS。

如果圖說文字驅動程式在篩選條件指定篩選動作的圖說文字已新增至篩選引擎之後，向篩選引擎註冊圖說文字，則篩選引擎不會呼叫圖說文字驅動程式的 notifyFn1 函式，以通知圖說文字是否有任何現有的篩選。篩選引擎會呼叫圖說驅動程式的 notifyFn1 函式，以在將指定篩選動作之圖說文字的新篩選新增至篩選引擎時通知圖說文字。在此情況下，圖說文字的 notifyFn1 函式可能不會針對篩選引擎中的每個篩選呼叫，該篩選引擎會指定篩選動作的圖說文字。如果圖說文字驅動程式在啟動篩選引擎之後註冊圖說文字，而且圖說文字必須知道篩選引擎中的每個篩選，以指定篩選動作的圖說文字，則圖說文字驅動程式必須呼叫適當的管理功能來列舉篩選引擎中的所有篩選，並排序產生的篩選清單，以尋找為篩選動作指定圖說文字的篩選。如需呼叫這些函式的詳細資訊，請參閱呼叫其他 Windows 篩選平臺函式。

從篩選引擎中刪除指定篩選動作的圖說文字時，篩選引擎會呼叫圖說文字驅動程式的 notifyFn1 函式，並在 filterKey參數中傳遞FWP_CALLOUT_NOTIFY_DELETE_FILTER，並在 filterKey 參數中傳遞FWP_CALLOUT_NOTIFY_DELETE_FILTER。如需詳細資訊，請參閱處理通知圖說文字。