Funzione UfxDeviceNotifyHardwareFailure (ufxclient.h)

Articolo
07/02/2025

Notifica a UFX un errore hardware non ripristinabile nel controller.

Sintassi

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

Parametri

[in] UfxDevice

Handle per un oggetto dispositivo UFX creato dal driver chiamando UfxDeviceCreate.

[in, optional] HardwareFailureContext

Puntatore facoltativo a una struttura di UFX_HARDWARE_FAILURE_CONTEXT definita dal driver client contenente informazioni specifiche del controller relative all'errore hardware.

Valore restituito

Nessuno

Osservazioni

Il driver client chiama UfxDeviceNotifyHardwareFailure quando il controller ha immesso un errore hardware non ripristinabile ,ad esempio il blocco PHY. UFX può provare a reimpostare il controller per verificare se il controller può essere recuperato. L'esempio seguente illustra la sintassi per la chiamata:

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10
piattaforma di destinazione	Finestre
intestazione	ufxclient.h
libreria	ufxstub.lib
IRQL	DISPATCH_LEVEL

Condividi tramite