Función NetDeviceRequestReset (netadaptercx.h)

La función NetDeviceRequestReset desencadena el marco NetAdapterCx para realizar la operación de restablecimiento de dispositivos 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 cliente creó anteriormente con una llamada a WdfDeviceCreate.

Valor devuelto

Ninguno

Observaciones

Un controlador cliente llama a netDeviceRequestReset cuando detecta un error en el dispositivo. netDeviceRequestReset devuelve inmediatamente al controlador cliente. El controlador solo puede llamar a netDeviceRequestReset en PASSIVE_LEVEL.

netDeviceRequestReset no es de bloqueo 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 de hardware o software irrecuperable, el controlador cliente puede usar la función WdfDeviceSetFailed.

Requisitos

Consulte también

recuperar una NIC que no responde con el PLDR de NetAdapterCx

WdfDeviceCreate

NET_DEVICE_RESET_CAPABILITIES