Fonction UfxDeviceNotifyHardwareFailure (ufxclient.h)

Avertit UFX d’une défaillance matérielle non récupérable dans le contrôleur.

Syntaxe

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

Paramètres

[in] UfxDevice

Handle vers un objet de périphérique UFX que le pilote a créé en appelant UfxDeviceCreate.

[in, optional] HardwareFailureContext

Pointeur facultatif vers une structure de UFX_HARDWARE_FAILURE_CONTEXT définie par le pilote client contenant des informations spécifiques au contrôleur sur la défaillance matérielle.

Valeur de retour

None

Remarques

Le pilote client appelle UfxDeviceNotifyHardwareFailure lorsque le contrôleur a entré une défaillance matérielle non récupérable (comme le verrouillage PHY). UFX peut essayer de réinitialiser le contrôleur pour voir si le contrôleur peut être récupéré. L’exemple suivant montre la syntaxe de l’appel :

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Plateforme cible	Windows
En-tête	ufxclient.h
Bibliothèque	ufxstub.lib
IRQL	DISPATCH_LEVEL