STOR_LOG_EVENT_DETAILS struttura (storport.h)

La struttura STOR_LOG_EVENT_DETAILS fornisce dettagli relativi agli eventi di log degli errori specifici di Storport e agli eventi del log di sistema.

Sintassi

typedef struct _STOR_LOG_EVENT_DETAILS {
  ULONG                       InterfaceRevision;
  ULONG                       Size;
  ULONG                       Flags;
  STOR_EVENT_ASSOCIATION_ENUM EventAssociation;
  ULONG                       PathId;
  ULONG                       TargetId;
  ULONG                       LunId;
  BOOLEAN                     StorportSpecificErrorCode;
  ULONG                       ErrorCode;
  ULONG                       UniqueId;
  ULONG                       DumpDataSize;
  PVOID                       DumpData;
  ULONG                       StringCount;
  PWSTR                       *StringList;
} STOR_LOG_EVENT_DETAILS, *PSTOR_LOG_EVENT_DETAILS;

Members

InterfaceRevision

Numero di revisione di questa interfaccia. Impostare su STOR_CURRENT_LOG_INTERFACE_REVISION per usare la versione dell'interfaccia corrispondente a questa struttura. Sia la costante che la struttura dei dati sono definite nello stesso file di intestazione. Questo membro è impostato su 0x00000100 per la prima revisione.

Size

Dimensione della struttura. Impostare prima di chiamare StorPortLogSystemEvent.

Flags

Attualmente non utilizzato. Deve essere zero.

EventAssociation

Specifica se l'evento deve essere associato all'adapter, alla destinazione o al LUN. Per gli eventi associati alla scheda e alla destinazione, l'evento viene registrato sull'oggetto dispositivo dell'adattatore. Per gli eventi associati a LUN, l'evento viene registrato sull'oggetto dispositivo lun se presente; in caso contrario, viene registrato sull'oggetto dispositivo dell'adattatore.

PathId

Percorso/bus SCSI corrispondente a questo evento.

TargetId

Controller di destinazione SCSI o dispositivo sul bus corrispondente a questo evento.

LunId

Numero di unità logica SCSI del dispositivo di destinazione corrispondente a questo evento.

StorportSpecificErrorCode

Se il valore ErrorCode è specifico di Storport e deve essere convertito con IOLOGMSG.DLL, questo valore è impostato su TRUE. Se il valore ErrorCode non è specifico di Storport e deve essere passato direttamente alla struttura di registrazione eventi di sistema, questo valore è impostato su FALSE.

ErrorCode

Codice di errore dell'evento da registrare.

UniqueId

Specifica un identificatore univoco associato al codice ErrorCode. Spesso viene usato come codice di posizione, facendo riferimento alla posizione nel miniport che ha attivato l'evento. Questo valore viene passato direttamente alla struttura di registrazione eventi.

DumpDataSize

Dimensioni del blocco di dati specifico del miniport che deve essere aggiunto alla voce di log. Se non viene scritto alcun blocco di dati, è necessario impostare su 0.

DumpData

Puntatore al blocco di dati specifico del miniport che deve essere aggiunto alla voce di log. Se non viene scritto alcun blocco di dati, DumpDataSize deve essere impostato su 0 e questo campo viene ignorato.

StringCount

Numero di stringhe Unicode con terminazione null contenute nel membro StringList. Se non devono essere scritte stringhe, questa stringa deve essere impostata su 0.

StringList

Elenco di stringhe Unicode con terminazione null da aggiungere alla voce di log da usare nella sostituzione di stringhe. Queste stringhe vengono sostituite per i segnaposto "%2" tramite "%n" nel testo del messaggio di log quando viene visualizzata la voce di log. Questo elenco è costituito da una matrice di puntatori alle stringhe Unicode con terminazione null. StringCount contiene il conteggio dei puntatori di stringa in questa matrice, quindi non è necessaria alcuna voce di terminazione elenco. Se non vengono scritte stringhe, StringCount deve essere impostato su 0 e questo campo viene ignorato.

Commenti

Anche se StorPortLogError usa i valori PathId, TargetId e LunId a 8 bit, per StorPortLogSystemEvent sono a 32 bit. Le dimensioni combinate dei dati di dump e delle aree stringa del driver miniport non possono superare 150 byte. Questa restrizione è dovuta al < limite di 255 byte che il kernel applica alle voci del registro eventi.

Requisiti

Requisito	Valore
Intestazione	Storport.h (include Storport.h)

Vedi anche

STOR_EVENT_ASSOCIATION_ENUM

StorPortLogSystemEvent