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);

要求

要求	值
最低受支持的客户端	Windows 10
目标平台	Windows
标头	ufxclient.h
Library	ufxstub.lib
IRQL	DISPATCH_LEVEL