Функция NdisFRestartFilter (ndis.h)
Драйвер фильтра вызывает функцию NdisFRestartFilter , чтобы запросить NDIS для запуска операции перезапуска для модуля фильтра.
Синтаксис
NDIS_STATUS NdisFRestartFilter(
[in] NDIS_HANDLE NdisFilterHandle
);
Параметры
[in] NdisFilterHandle
Дескриптор NDIS, идентифицирующий этот модуль фильтра. NDIS передал дескриптор драйверу фильтра в вызове функции FilterAttach .
Возвращаемое значение
NdisFRestartFilter возвращает одно из следующих значений состояния:
| Код возврата | Описание |
|---|---|
|
NdisFRestartFilter возвращает NDIS_STATUS_SUCCESS, если запущена операция перезапуска. |
|
Сбой NdisFRestartFilter из-за нехватки ресурсов. |
|
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) |