Функция NetDeviceRequestReset (netadaptercx.h)

  • Статья

Функция NetDeviceRequestReset активирует платформу NetAdapterCx для выполнения операции сброса устройства на уровне платформы, которая восстанавливает устройство сетевой карты, не отвечающее на запросы.

Синтаксис

void NetDeviceRequestReset(
  [_In_] WDFDEVICE Device
);

Параметры

[_In_] Device

Объект WDFDEVICE, ранее созданный драйвером клиента с помощью вызова WdfDeviceCreate.

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

None

Remarks

Драйвер клиента вызывает NetDeviceRequestReset при обнаружении сбоя устройства. NetDeviceRequestReset немедленно возвращается драйверу клиента. Драйвер может вызывать NetDeviceRequestReset только в PASSIVE_LEVEL.

NetDeviceRequestReset не блокируется и немедленно возвращается драйверу клиента. Драйвер клиента должен отменить все текущие задания, которые обращаются к устройству, на которое в данный момент произошел сбой.

Рекомендуется, чтобы клиентские драйверы настраивали структуру NET_DEVICE_RESET_CAPABILITIES для сбора значимых диагностика сброса в процессе сброса и восстановления устройства. Дополнительные сведения о сборе диагностика сброса см. в разделе Регистрация необязательного обратного вызова коллекции диагностика.

NetDeviceRequestReset применим только к сетевым картам на основе PCIe. Для сетевых адаптеров на основе USB выполните процедуру, описанную в разделе Восстановление после ошибок USB-канала.

Если на устройстве возникает неустранимая ошибка оборудования или программного обеспечения, драйвер клиента может использовать функцию WdfDeviceSetFailed .

Требования

Требование Значение
Минимальная версия клиента Windows 11
Минимальная версия сервера Windows Server 2022
Верхняя часть netadaptercx.h (включая netadaptercx.h)
IRQL PASSIVE_LEVEL

См. также раздел

Восстановление сетевого адаптера, не отвечающего на запросы, с помощью NETAdapterCx PLDR

WdfDeviceCreate

NET_DEVICE_RESET_CAPABILITIES