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)

Vedi anche

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK

ScsiPortLogError

StorPortLogSystemEvent