Функция 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 , содержащую сведения о сбое оборудования, относящиеся к контроллеру.

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

None

Remarks

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

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


Требования

Требование Значение
Минимальная версия клиента Windows 10
Целевая платформа Windows
Header ufxclient.h
Библиотека ufxstub.lib
IRQL DISPATCH_LEVEL