UfxDeviceNotifyHardwareFailure, fonction (ufxclient.h)

Article
02/07/2025

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 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

Aucun

Remarques

Le pilote client appelle UfxDeviceNotifyHardwareFailure lorsque le contrôleur a entré une défaillance matérielle non récupérable (par exemple, phy lockup). 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);

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10
plateforme cible	Windows
d’en-tête	ufxclient.h
bibliothèque	ufxstub.lib
IRQL	DISPATCH_LEVEL

Partager via