FWPS_CALLOUT_NOTIFY_FN0回呼函式 (fwpsk.h)

發行項
02/26/2024

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

注意notifyFn0 是 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 圖說文字函式可以設定此結構 的內容 成員，以在將篩選新增至篩選引擎時指向圖說文字驅動程式提供的內容結構。此內容結構對篩選引擎不透明，而且可由圖說文字驅動程式的classifyFn0 圖說文字函式使用，以保留篩選引擎對圖說文字驅動程式呼叫之間的任何驅動程式特定數據或狀態資訊
classifyFn0 圖說文字函式。

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

傳回值

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

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

備註

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

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

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

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