Função UfxDeviceNotifyHardwareFailure (ufxclient.h)

Notifica a UFX sobre uma falha de hardware não recuperável no controlador.

Sintaxe

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

Parâmetros

[in] UfxDevice

Um identificador para um objeto de dispositivo UFX que o driver criou chamando UfxDeviceCreate.

[in, optional] HardwareFailureContext

Ponteiro opcional para uma estrutura de UFX_HARDWARE_FAILURE_CONTEXT definida pelo driver do cliente que contém informações específicas do controlador sobre a falha de hardware.

Retornar valor

Nenhum

Comentários

O driver cliente chama UfxDeviceNotifyHardwareFailure quando o controlador inseriu uma falha de hardware não recuperável (como bloqueio PHY). O UFX pode tentar redefinir o controlador para ver se o controlador pode ser recuperado. O exemplo a seguir mostra a sintaxe da chamada:

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10
Plataforma de Destino	Windows
Cabeçalho	ufxclient.h
Biblioteca	ufxstub.lib
IRQL	DISPATCH_LEVEL