функция обратного вызова FWPS_CALLOUT_NOTIFY_FN1 (fwpsu.h)

Обработчик фильтров вызывает функцию выноски notifyFn1 выноски, чтобы уведомить драйвер выноски о событиях, связанных с выноской.

Синтаксис

FWPS_CALLOUT_NOTIFY_FN1 FwpsCalloutNotifyFn1;

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

Параметры

notifyType

Значение типа , указывающее тип уведомления, которое обработчик фильтров отправляет в выноску. Допустимые значения для этого параметра:

FWPS_CALLOUT_NOTIFY_ADD_FILTER. В обработчик фильтров добавляется фильтр, указывающий выноску для действия фильтра.

FWPS_CALLOUT_NOTIFY_DELETE_FILTER. Фильтр удаляется из обработчика фильтров, который задает выноску для действия фильтра.

FWPS_CALLOUT_NOTIFY_TYPE_MAX. Максимальное значение для целей тестирования.

filterKey

Указатель на идентификатор управления для фильтра, заданный приложением или драйвером, который добавляет или удаляет фильтр. Значение должно иметь значение NULL , если параметр notifyType имеет значение FWPS_CALLOUT_NOTIFY_DELETE_FILTER. Дополнительные сведения см. в подразделе "Примечания".

filter

Указатель на структуру FWPS_FILTER1 . Эта структура описывает фильтр, который добавляется в подсистему фильтров или удаляется из нее.

Функция выноски notifyFn1 может задать элемент контекста этой структуры так, чтобы он указывал на предоставленную драйвером выноски структуру контекста при добавлении фильтра в подсистему фильтрации. Эта контекстная структура является непрозрачной для подсистемы фильтрации и может использоваться функцией выноски classifyFn1 драйвера выноски для сохранения любых данных или сведений о состоянии драйвера между вызовами подсистемы фильтров к функции выноски classifyFn1 драйвера выноски.

Функция выноски notifyFn1 может очистить любой контекст, связанный с фильтром, при удалении фильтра из обработчика фильтров.

Возвращаемое значение

Функция notifyFn1 выноски возвращает один из следующих кодов NTSTATUS .

Комментарии

Драйвер выноски регистрирует функции выноски в обработчике фильтров, вызывая функцию FwpsCalloutRegister1 .

Обработчик фильтров вызывает функцию выноски notifyFn1 выноски, чтобы уведомить драйвер выноски о событиях, связанных с выноской. Если функция выноски notifyFn1 драйвера выноски не распознает тип уведомления, передаваемого в параметре notifyType , она игнорирует уведомление и возвращает STATUS_SUCCESS.

Если драйвер выноски регистрирует выноску в обработчике фильтров после того, как фильтры, указывающие выноску для действия фильтра, уже были добавлены в подсистему фильтров, обработчик фильтров не вызывает функцию выноски notifyFn1 драйвера выноски, чтобы уведомить выноску о существующих фильтрах. Модуль фильтров вызывает функцию выноски notifyFn1 драйвера выноски, чтобы уведомить выноску о добавлении новых фильтров, указывающих выноску для действия фильтра. В этом случае функция выноски notifyFn1 выноски может не вызываться для каждого фильтра в обработчике фильтров, который задает выноску для действия фильтра. Если драйвер выноски регистрирует выноску после запуска обработчика фильтров и выноска должна знать о каждом фильтре в механизме фильтрации, который указывает выноску для действия фильтра, драйвер выноски должен вызвать соответствующие функции управления для перечисления всех фильтров в подсистеме фильтров и отсортировать полученный список фильтров, чтобы найти те, которые указывают выноску для действия фильтра. Дополнительные сведения о вызове этих функций см. в статье Вызов других функций платформы фильтрации Windows .

Когда фильтр, указывающий выноску для действия фильтра, удаляется из обработчика фильтров, обработчик фильтров вызывает функцию выноски notifyFn1 драйвера выноски и передает FWP_CALLOUT_NOTIFY_DELETE_FILTER в параметре notifyType и NULL в параметре filterKey. Дополнительные сведения см. в разделе Обработка выносок уведомлений.

Требования