Función UfxDeviceNotifyHardwareFailure (ufxclient.h)

Notifica a UFX sobre un error de hardware no recuperable en el controlador.

Sintaxis

void UfxDeviceNotifyHardwareFailure(
  [in]           UFXDEVICE                     UfxDevice,
  [in, optional] PUFX_HARDWARE_FAILURE_CONTEXT HardwareFailureContext
);

Parámetros

[in] UfxDevice

Identificador de un objeto de dispositivo UFX que creó el controlador llamando a UfxDeviceCreate.

[in, optional] HardwareFailureContext

Puntero opcional a una estructura de UFX_HARDWARE_FAILURE_CONTEXT definida por el controlador de cliente que contiene información específica del controlador sobre el error de hardware.

Valor devuelto

Ninguno

Observaciones

El controlador cliente llama a UfxDeviceNotifyHardwareFailure cuando el controlador ha introducido un error de hardware no recuperable (por ejemplo, bloqueo PHY). UFX puede intentar restablecer el controlador para ver si se puede recuperar el controlador. En el ejemplo siguiente se muestra la sintaxis de la llamada:

    UfxDeviceNotifyHardwareFailure(
        ControllerContext->UfxDevice,
        (PUFX_HARDWARE_FAILURE_CONTEXT) HardwareFailureContext);

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10
de la plataforma de destino de	Windows
encabezado de	ufxclient.h
biblioteca de	ufxstub.lib
irQL	DISPATCH_LEVEL