Функция UfxDeviceNotifyHardwareFailure (ufxclient.h)

Уведомляет UFX о невосстановимом сбое оборудования в контроллере.

Синтаксис

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

Параметры

[in] UfxDevice

Дескриптор объекта устройства UFX, созданного драйвером, вызывая UfxDeviceCreate.

[in, optional] HardwareFailureContext

Необязательный указатель на определяемую драйвером клиента структуру UFX_HARDWARE_FAILURE_CONTEXT, содержащую сведения о сбое оборудования для конкретного контроллера.

Возвращаемое значение

Никакой

Замечания

Драйвер клиента вызывает UfxDeviceNotifyHardwareFailure, когда контроллер ввел невосстановляемый аппаратный сбой (например, блокировка PHY). UFX может попытаться сбросить контроллер, чтобы узнать, можно ли восстановить контроллер. В следующем примере показан синтаксис вызова:

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


Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 10
целевая платформа Виндоус
заголовка ufxclient.h
библиотеки ufxstub.lib
IRQL DISPATCH_LEVEL