共用方式為

FWPS_CALLOUT_NOTIFY_FN3回呼函式 （fwpsk.h）

  • 發行項

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

語法

FWPS_CALLOUT_NOTIFY_FN3 FwpsCalloutNotifyFn3;

NTSTATUS FwpsCalloutNotifyFn3(
  FWPS_CALLOUT_NOTIFY_TYPE notifyType,
  const GUID *filterKey,
  FWPS_FILTER3 *filter
)
{...}

參數

notifyType

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

  • FWPS_CALLOUT_NOTIFY_ADD_FILTER：正在將篩選新增至篩選引擎，以指定篩選動作的圖說文字。
  • FWPS_CALLOUT_NOTIFY_DELETE_FILTER：正在從篩選引擎中刪除篩選，以指定篩選動作的註標。
  • FWPS_CALLOUT_NOTIFY_TYPE_MAX：測試用途的最大值。

filterKey

篩選之管理識別碼的指標，如新增或刪除篩選之應用程式或驅動程式所指定。 如果 notifyType 參數設定為 FWPS_CALLOUT_NOTIFY_DELETE_FILTER，則必須 NULL。 如需詳細資訊，請參閱<。

filter

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

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

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

傳回值

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

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

言論

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

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

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

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

要求

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

另請參閱