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

Consulte también

Recuperación de una NIC no responde con NetAdapterCx PLDR

WdfDeviceCreate

NET_DEVICE_RESET_CAPABILITIES