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

Статья
08/07/2023

Драйвер мини-порта должен вызвать функцию NdisMRestartComplete , чтобы завершить операцию перезапуска, если драйвер вернул NDIS_STATUS_PENDING из своей функции MiniportRestart .

Синтаксис

void NdisMRestartComplete(
  [in] IN NDIS_HANDLE MiniportAdapterHandle,
  [in] IN NDIS_STATUS Status
);

Параметры

[in] MiniportAdapterHandle

Адаптер мини-порта обрабатывает, что NDIS передается параметру MiniportAdapterHandleФункция MiniportInitializeEx.

[in] Status

Окончательное состояние операции перезапуска. Поддерживаются следующие значения состояния:

NDIS_STATUS_SUCCESS

Драйвер успешно перезапустил поток сетевых данных через адаптер мини-порта.

NDIS_STATUS_RESOURCES

Перезагрузка завершилась сбоем из-за нехватки ресурсов.

NDIS_STATUS_FAILURE

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

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

None

Remarks

Адаптер мини-порта, указанный в miniportAdapterHandle , переходит в состояние Перезапуск, когда NDIS вызывает функцию MiniportRestart .

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

Драйвер мини-порта может возобновить работу с указанием полученных пакетов сразу после вызова NDIS MiniportRestart и до вызова NdisMRestartComplete. После завершения запроса на перезапуск драйвер должен быть готов к приему запросов на отправку.

Требования

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