UfxDeviceNotifyHardwareFailure 函数 （ufxclient.h）

通知 UFX 控制器中不可恢复的硬件故障。

语法

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

参数

[in] UfxDevice

通过调用 UfxDeviceCreate 调用驱动程序创建的 UFX 设备对象的句柄。

[in, optional] HardwareFailureContext

指向客户端驱动程序定义的 UFX_HARDWARE_FAILURE_CONTEXT 结构的可选指针，其中包含有关硬件故障的特定于控制器的信息。

返回值

没有

言论

当控制器进入不可恢复的硬件故障（例如 PHY 锁定）时，客户端驱动程序调用 UfxDeviceNotifyHardwareFailure。 UFX 可以尝试重置控制器，看看是否可以恢复控制器。 以下示例演示调用的语法：

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

要求