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 mediante una llamada 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

None

Observaciones

El controlador cliente llama a UfxDeviceNotifyHardwareFailure cuando el controlador ha entrado en un error de hardware no recuperable (como el 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