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 der Treiber durch Aufrufen von UfxDeviceCreate erstellt hat.

[in, optional] HardwareFailureContext

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

Rückgabewert

Keine

Bemerkungen

Der Clienttreiber ruft UfxDeviceNotifyHardwareFailure auf, wenn der Controller einen nicht wiederherstellbaren Hardwarefehler (z. B. PHY-Lockup) aufgetreten ist. 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