Функция 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 |
| Минимальная версия UMDF | 2.33 |
| Верхняя часть | netadaptercx.h (включая netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |
См. также раздел
Восстановление сетевого адаптера, не отвечающего на запросы, с помощью NETAdapterCx PLDR