Функция NdisFRestartFilter (ndis.h)

Статья
08/07/2023

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

Синтаксис

NDIS_STATUS NdisFRestartFilter(
  [in] NDIS_HANDLE NdisFilterHandle
);

Параметры

[in] NdisFilterHandle

Дескриптор NDIS, идентифицирующий этот модуль фильтра. NDIS передал дескриптор драйверу фильтра в вызове функции FilterAttach .

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

NdisFRestartFilter возвращает одно из следующих значений состояния:

Код возврата	Описание
NDIS_STATUS_SUCCESS	NdisFRestartFilter возвращает NDIS_STATUS_SUCCESS, если запущена операция перезапуска.
NDIS_STATUS_RESOURCES	Сбой NdisFRestartFilter из-за нехватки ресурсов.
NDIS_STATUS_FAILURE	NdisFRestartFilter возвращает NDIS_STATUS_FAILURE, если ни одно из указанных выше значений не применяется.

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

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

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	Irql_Filter_Driver_Function(ndis)

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

FilterAttach

FilterSetModuleOptions

NdisSetOptionalHandlers

Share via