Funzione StorPortMarkDeviceFailedEx (storport.h)

Articolo
02/07/2025

La routine StorPortMarkDeviceFailed Ex contrassegna un dispositivo con stato di errore e fornisce i dati che potrebbero essere necessari per la diagnosi.

Sintassi

ULONG StorPortMarkDeviceFailedEx(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS StorAddress,
  ULONG         Flags,
  USHORT        FaultCode,
  PWSTR         FaultDescription,
  USHORT        AdditionalDataSize,
  PUCHAR        AdditionalData,
  USHORT        CriticalDataSize,
  PUCHAR        CriticalData
);

Parametri

HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore bus host (HBA).

StorAddress

Indirizzo del dispositivo di unità di archiviazione. Questo parametro è NULL per i dispositivi adattatori.

Flags

Indica il comportamento richiesto dal miniport. i flag possono essere impostati su uno dei valori seguenti.

Bandiera	Significato
STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE	Rimuovere il dispositivo non riuscito.
STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE	Indica che si tratta di un errore previsto del dispositivo.

FaultCode

Codice di errore specifico del miniport.

FaultDescription

Stringa leggibile che descrive l'errore.

AdditionalDataSize

Dimensioni in byte del buffer a cui AdditionalData.

AdditionalData

Puntatore a un buffer contenente dati aggiuntivi associati alla condizione di errore.

CriticalDataSize

Dimensioni in byte del buffer a cui punta CriticalData.

CriticalData

Puntatore a un buffer contenente dati critici associati alla condizione di errore.

Valore restituito

StorPortMarkDeviceFailedEx restituisce un codice di STOR_STATUS valido.

Osservazioni

Un driver miniport può chiamare questa funzione per contrassegnare un dispositivo non riuscito o per indicare che il dispositivo ha potenzialmente avuto esito negativo.

Se non sono impostati flag in Flag, Storport logerà solo l'evento.

Il gestore PnP invierà un IRP per eseguire una query sullo stato PnP del dispositivo non riuscito. Se Flag è impostato su STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE e non è impostato su STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE, il gestore PnP tenterà di rimuovere il dispositivo non riuscito.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 2004
intestazione	storport.h

Vedere anche

IoInvalidateDeviceState

StorPortMarkDeviceFailed

Condividi tramite