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

Статья
02/26/2024

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

ПримечаниеnotifyFn1 — это конкретная версия notifyFn, используемая в Windows 7 и более поздних версиях. Дополнительные сведения см. в разделах ИМЕНА 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

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

[in] filter

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

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

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

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

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

Код возврата	Описание
STATUS_SUCCESS	Драйвер выноски принимает уведомление от обработчика фильтров.
Другие коды состояния	Произошла ошибка. Если параметр notifyType имеет FWPS_CALLOUT_NOTIFY_ADD_FILTER, фильтр не будет добавлен в подсистему фильтров. Если параметр notifyType FWPS_CALLOUT_NOTIFY_DELETE_FILTER, фильтр по-прежнему будет удален из подсистемы фильтров.

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 7.
Целевая платформа	Windows
Header	fwpsk.h (включая Fwpsk.h)
IRQL	<= DISPATCH_LEVEL