FWPS_CALLOUT_NOTIFY_FN0回呼函式（fwpsk.h）

發行項
02/07/2025

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

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

語法

FWPS_CALLOUT_NOTIFY_FN0 FwpsCalloutNotifyFn0;

NTSTATUS FwpsCalloutNotifyFn0(
  [in] FWPS_CALLOUT_NOTIFY_TYPE notifyType,
  [in] const GUID *filterKey,
  [in] FWPS_FILTER0 *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_FILTER0 結構的指標。此結構描述要加入或刪除篩選引擎的篩選。

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

圖說文字的 notifyFn0 圖說函式可以在從篩選引擎中刪除篩選條件時清除與篩選相關聯的任何內容。

傳回值

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

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

言論

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

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

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

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