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

Статья
02/26/2024

Уведомляет 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

Поделиться через