Función NetDeviceRequestReset (netadaptercx.h)
La función NetDeviceRequestReset desencadena el marco NetAdapterCx para realizar la operación de restablecimiento de dispositivo de nivel de plataforma que recupera un dispositivo NIC no responde.
Sintaxis
void NetDeviceRequestReset(
[_In_] WDFDEVICE Device
);
Parámetros
[_In_] Device
Objeto WDFDEVICE que el controlador de cliente creó anteriormente con una llamada a WdfDeviceCreate.
Valor devuelto
None
Observaciones
Un controlador de cliente llama a NetDeviceRequestReset cuando detecta un error en el dispositivo. NetDeviceRequestReset vuelve inmediatamente al controlador cliente. El controlador solo puede llamar a NetDeviceRequestReset en PASSIVE_LEVEL.
NetDeviceRequestReset no está bloqueando y vuelve inmediatamente al controlador cliente. El controlador cliente debe cancelar los trabajos en curso que tengan acceso al dispositivo con errores actualmente.
Se recomienda que los controladores de cliente configuren una estructura de NET_DEVICE_RESET_CAPABILITIES para recopilar diagnósticos de restablecimiento significativos durante el proceso de restablecimiento y recuperación del dispositivo. Para obtener más información sobre cómo recopilar diagnósticos de restablecimiento, consulte Registro de la devolución de llamada de recopilación de diagnóstico opcional.
NetDeviceRequestReset solo es aplicable a dispositivos NIC basados en PCIe. En el caso de los dispositivos NIC basados en USB, siga el proceso descrito en Recuperación de errores de canalización USB.
Si el dispositivo encuentra un error irrecuperable de hardware o software, el controlador cliente puede usar la función WdfDeviceSetFailed .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 11 |
| Servidor mínimo compatible | Windows Server 2022 |
| Versión mínima de UMDF | 2,33 |
| Encabezado | netadaptercx.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |