UfxDeviceNotifyHardwareFailure-Funktion (ufxclient.h)

Benachrichtigt UFX über einen nicht wiederherstellbaren Hardwarefehler im Controller.

Syntax

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

Parameter

[in] UfxDevice

Ein Handle für ein UFX-Geräteobjekt, das vom Treiber erstellt wurde, indem UfxDeviceCreateaufgerufen wird.

[in, optional] HardwareFailureContext

Optionaler Zeiger auf eine vom Clienttreiber definierte UFX_HARDWARE_FAILURE_CONTEXT Struktur, die controllerspezifische Informationen zum Hardwarefehler enthält.

Rückgabewert

Nichts

Bemerkungen

Der Clienttreiber ruft UfxDeviceNotifyHardwareFailure auf, wenn der Controller einen nicht wiederherstellbaren Hardwarefehler (z. B. PHY-Sperrung) eingegeben hat. UFX kann versuchen, den Controller zurückzusetzen, um festzustellen, ob der Controller wiederhergestellt werden kann. Das folgende Beispiel zeigt die Syntax für den Aufruf:

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

Anforderungen