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 que 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 cliente llama a NetDeviceRequestReset cuando detecta un error del dispositivo. NetDeviceRequestReset vuelve inmediatamente al controlador cliente. El controlador solo puede llamar a NetDeviceRequestReset en PASSIVE_LEVEL.

NetDeviceRequestReset no se bloquea 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 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ósticos 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
Encabezado	netadaptercx.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Consulte también

Recuperación de una NIC que no responde con NetAdapterCx PLDR

WdfDeviceCreate

NET_DEVICE_RESET_CAPABILITIES