структура FWPS_CALLOUT0 (fwpsk.h)

Структура FWPS_CALLOUT0 определяет данные, необходимые драйверу выноски для регистрации выноски в обработчике фильтров.

Обратите вниманиеFWPS_CALLOUT0 является конкретной версией FWPS_CALLOUT, используемой в Windows Vista и более поздних версиях. Дополнительные сведения см. в разделах ИМЕНА Version-Independent ВПП и Выбор конкретных версий Windows . Для Windows 8 доступно FWPS_CALLOUT2. Для Windows 7 доступно FWPS_CALLOUT1 .
 

Синтаксис

typedef struct FWPS_CALLOUT0_ {
  GUID                                calloutKey;
  UINT32                              flags;
  FWPS_CALLOUT_CLASSIFY_FN0           classifyFn;
  FWPS_CALLOUT_NOTIFY_FN0             notifyFn;
  FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT0;

Члены

calloutKey

Guid, определяемый драйвером выноски, который однозначно идентифицирует выноску.

flags

Флаги, указывающие параметры выноски. Возможные флаги:

FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW

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

FWP_CALLOUT_FLAG_ALLOW_OFFLOAD

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

classifyFn

Указатель на функцию выноски classifyFn0 драйвера выноски. Подсистема фильтрации вызывает эту функцию всякий раз, когда есть сетевые данные для обработки выноской.

notifyFn

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

flowDeleteFn

Указатель на функцию выноски flowDeleteFn драйвера выноски. Подсистема фильтрации вызывает эту функцию всякий раз, когда поток данных, обрабатываемый выноской, завершается.

Если драйвер выноски не связывает контекст с потоками данных, которые обрабатывает выноска, этот элемент должен иметь значение NULL.

Комментарии

Драйвер выноски передает указатель на инициализированную структуру FWPS_CALLOUT0 функцию FwpsCalloutRegister0 при регистрации выноски с помощью обработчика фильтров.

Выноска может установить флаг FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW только для подключений, для которых драйвер заинтересован в выполнении проверки потока. Эта выноска будет игнорироваться во всех остальных подключениях. Производительность будет повышена, и драйверу не придется поддерживать ненужные данные о состоянии.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows Vista.
Верхняя часть fwpsk.h (включая Fwpsk.h)

См. также раздел

FWPS_CALLOUT1

FWPS_CALLOUT2

FwpsCalloutRegister0

classifyFn0

flowDeleteFn

notifyFn0