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

Драйвер фильтра вызывает функцию 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 (include Ndis.h)
библиотеки Ndis.lib
IRQL <= DISPATCH_LEVEL
правил соответствия DDI Irql_Filter_Driver_Function(ndis)

См. также

FilterAttach

FilterSetModuleOptions

NdisSetOptionalHandlers