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

Статья
02/29/2024

Драйвер фильтра должен вызвать функцию 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, если ни одно из предыдущих значений не применяется. Драйвер должен вызвать функцию NdisWriteEventLogEntry вместе с параметрами, указывающими причину сбоя.

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

None

Remarks

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

Ожидающая операция перезапуска завершается после того, как драйвер вызывает функцию NdisFRestartComplete . После завершения операции перезапуска модуль фильтра находится в состоянии Выполняется .

Драйвер фильтра может возобновить работу, указывая полученные сетевые данные сразу после вызова NDIS FilterRestart и до вызова драйвера NdisFRestartComplete. После завершения операции перезапуска драйвер должен быть готов к приему запросов на отправку.

Требования

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