Funzione StorPortLogError (storport.h)
La routine StorPortLogError notifica al driver di porta che si è verificato un errore.
Sintassi
STORPORT_API VOID StorPortLogError(
[in] PVOID HwDeviceExtension,
[in, optional] PSCSI_REQUEST_BLOCK Srb,
[in] UCHAR PathId,
[in] UCHAR TargetId,
[in] UCHAR Lun,
[in] ULONG ErrorCode,
[in] ULONG UniqueId
);
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo hardware. Si tratta di un'area di archiviazione hbA che il driver di porta alloca e inizializza per conto del driver miniport. I driver miniport in genere archiviano informazioni specifiche di HBA in questa estensione, ad esempio lo stato dell'HBA e gli intervalli di accesso mappati per l'HBA. Questa area è disponibile per il miniport subito dopo che il driver miniport chiama StorPortInitialize. Il driver di porta libera questa memoria quando rimuove il dispositivo.
[in, optional] Srb
Puntatore a un blocco di richiesta SCSI se è associato all'errore. In caso contrario, questo parametro è NULL.
[in] PathId
Identifica il bus SCSI.
[in] TargetId
Identifica il controller di destinazione o il dispositivo nel bus.
[in] Lun
Identifica il numero di unità logica del dispositivo di destinazione.
[in] ErrorCode
Specifica un codice di errore che indica uno dei valori seguenti come tipo di errore.
| Valore | Significato |
|---|---|
| SP_BAD_FW_ERROR | Indica che il driver ha rilevato un firmware non valido o precedente. Il dispositivo non verrà usato. |
| SP_BAD_FW_WARNING | Indica che il driver ha rilevato una scheda con firmware precedente o non valido, che può causare prestazioni o funzionalità ridotte. |
| SP_BUS_PARITY_ERROR | Indica che è stato rilevato un errore di parità del bus SCSI. |
| SP_BUS_TIME_OUT | Indica una connessione del bus SCSI a un timeout logico. |
| SP_INTERNAL_ADAPTER_ERROR | Indica che è stato rilevato un errore HBA interno. |
| SP_INVALID_RESELECTION | Indica un'unità logica rielezione in modo imprevisto o con un tag di coda non valido. |
| SP_IRQ_NOT_RESPONDING | Indica che l'HBA non interrompe quando previsto. |
| SP_PROTOCOL_ERROR | Indica che il driver miniport ha rilevato un errore del protocollo del bus SCSI. |
| SP_REQUEST_TIMEOUT | Indica che un'operazione al controller è scaduta. |
| SP_UNEXPECTED_DISCONNECT | Indica che una destinazione è disconnessa in modo imprevisto. |
[in] UniqueId
Specifica un identificatore univoco per l'errore. Questo valore differenzia l'errore corrente da altri errori con lo stesso valore ErrorCode . Per alcuni driver miniport, questo identifica la riga di codice in cui è stato rilevato l'errore. Per altri, sono informazioni aggiuntive restituite dall'HBA.
Valore restituito
nessuno
Osservazioni
Il driver della porta registra un errore nel registro eventi di sistema.
A partire da Windows 8, il parametro Srb può puntare a SCSI_REQUEST_BLOCK o STORAGE_REQUEST_BLOCK. Se l'identificatore di funzione nel campo Funzione di Srb è SRB_FUNCTION_STORAGE_REQUEST_BLOCK, SRB è una struttura di richiesta STORAGE_REQUEST_BLOCK .
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | Storport.h (include Storport.h) |
| Libreria | Storport.lib |
| Regole di conformità DDI | StorPortDeprecated(storport) |