Функция NetDeviceRequestReset (netadaptercx.h)
Функция NetDeviceRequestReset активирует платформу NetAdapterCx для выполнения операции сброса устройства на уровне платформы, которая восстанавливает устройство без ответа.
Синтаксис
void NetDeviceRequestReset(
[_In_] WDFDEVICE Device
);
Параметры
[_In_] Device
Объект WDFDEVICE, созданный ранее с вызовом WdfDeviceCreate.
Возвращаемое значение
Никакой
Замечания
Драйвер клиента вызывает 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 (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |
См. также
восстановление неответственного сетевого адаптера с помощью NetAdapterCx PLDR