Функция NdisFRestartComplete (ndis.h)
Драйвер фильтра должен вызвать функцию NdisFRestartComplete, чтобы завершить операцию перезапуска, если драйвер вернул NDIS_STATUS_PENDING из функции FilterRestart.
Синтаксис
void NdisFRestartComplete(
[in] NDIS_HANDLE NdisFilterHandle,
[in] NDIS_STATUS Status
);
Параметры
[in] NdisFilterHandle
Дескриптор NDIS, определяющий этот модуль фильтра. NDIS передал дескриптор драйверу фильтра в вызове функции FilterAttach.
[in] Status
Окончательное состояние операции перезапуска. Поддерживаются следующие значения состояния:
NDIS_STATUS_SUCCESS
Драйвер успешно перезагрузил поток сетевых данных.
NDIS_STATUS_RESOURCES
Сбой перезапуска из-за нехватки ресурсов.
NDIS_STATUS_FAILURE
Драйвер указывает NDIS_STATUS_FAILURE, если ни одно из предыдущих значений не применяется. Драйвер должен вызвать функцию NdisWriteEventLogEnt ry вместе с параметрами, указывающими причину сбоя.
Возвращаемое значение
Никакой
Замечания
NDIS вызывает функцию драйвера фильтра FilterRestart для запуска запроса перезапуска модуля фильтрации. Модуль фильтра остается в состоянии перезапуска до завершения операции перезапуска.
Ожидающая перезагрузка завершается после вызова драйвера функции NdisFRestartComplete. Модуль фильтра находится в состоянии выполнение после завершения операции перезапуска.
Драйвер фильтра может возобновить работу, указывая, что полученные сетевые данные сразу после вызова NDIS FilterRestart и до вызова драйвера NdisFRestartComplete. Драйвер должен быть готов принять запросы на отправку после завершения операции перезапуска.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Поддерживается в NDIS 6.0 и более поздних версиях. |
| целевая платформа | Настольный |
| заголовка | ndis.h (include Ndis.h) |
| библиотеки | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| правил соответствия DDI | Irql_Filter_Driver_Function(ndis) |