функция обратного вызова FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 (fwpsk.h)
Модуль фильтрации вызывает функцию выноски flowDeleteFn выноски, чтобы уведомить выноску о том, что поток данных, обрабатываемый выноской, завершается.
Синтаксис
FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 FwpsCalloutFlowDeleteNotifyFn0;
void FwpsCalloutFlowDeleteNotifyFn0(
[in] UINT16 layerId,
[in] UINT32 calloutId,
[in] UINT64 flowContext
)
{...}
Параметры
[in] layerId
Идентификатор времени выполнения для уровня фильтрации, на котором завершается поток данных. Дополнительные сведения см. в разделе Идентификаторы слоев фильтрации во время выполнения.
[in] calloutId
Идентификатор времени выполнения для выноски в обработчике фильтров. Это тот же идентификатор, который был возвращен, когда драйвер выноски вызывал функции FwpsCalloutRegister0 или FwpsCalloutRegister1 для регистрации выноски в обработчике фильтров.
[in] flowContext
Последний контекст, связанный с потоком данных путем вызова функции FwpsFlowAssociateContext0 .
Возвращаемое значение
None
Remarks
Драйвер выноски регистрирует функции выноски в обработчике фильтров, вызывая функции FwpsCalloutRegister0 или FwpsCalloutRegister1 .
Обработчик фильтров вызывает функцию выноски flowDeleteFn выноски, когда она завершает поток данных, чтобы выноска удалялась в контексте, связанном с потоком данных. Например, эта функция выноски будет вызываться после резкой остановки из RST без первого вызова classifyFn . Обработчик фильтров вызывает эту функцию выноски, только если драйвер выноски связывает контекст с потоком данных. При завершении потока данных контекст будет автоматически удален из потока данных подсистемой фильтрации.
Модуль фильтрации вызывает функцию выноски flowDeleteFn выноски, только если выноска была ранее добавлена в подсистему фильтрации на уровне фильтрации, поддерживающем потоки данных, а драйвер выноски связывает контекст с потоками данных, которые он обрабатывает. Если драйвер выноски не связывает контекст с потоками данных, которые обрабатывает выноска, он не должен реализовывать функцию выноски flowDeleteFn для выноски. В этом случае драйвер выноски должен задать
Элемент flowDeleteFnструктуры FWPS_CALLOUT0 значение NULL при регистрации выноски в обработчике фильтров.
Тип FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 определяется как указатель на функцию flowDeleteFn следующим образом.
typedef void (NTAPI *FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0) flowDeleteFn
Обработчик фильтров вызывает функцию выноски flowDeleteFn в IRQL <= DISPATCH_LEVEL.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно начиная с Windows Vista. |
| Целевая платформа | Windows |
| Header | fwpsk.h (включая Fwpsk.h) |
| IRQL | <= DISPATCH_LEVEL |