Funzione UfxDeviceNotifyHardwareFailure (ufxclient.h)

Notifica a UFX di un errore hardware non recuperabile nel controller.

Sintassi

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

Parametri

[in] UfxDevice

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

[in, optional] HardwareFailureContext

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

Valore restituito

nessuno

Osservazioni

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

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10
Piattaforma di destinazione	Windows
Intestazione	ufxclient.h
Libreria	ufxstub.lib
IRQL	DISPATCH_LEVEL