structure STOR_LOG_EVENT_DETAILS (storport.h)

Article
02/29/2024

La structure STOR_LOG_EVENT_DETAILS fournit des détails relatifs aux événements du journal des erreurs spécifiques à Storport et aux événements du journal système.

Syntaxe

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;

Membres

InterfaceRevision

Numéro de révision de cette interface. Définissez sur STOR_CURRENT_LOG_INTERFACE_REVISION pour utiliser la version de l’interface qui correspond à cette structure. La constante et la structure de données sont définies dans le même fichier d’en-tête. Ce membre est défini sur 0x00000100 pour la première révision.

Size

La taille de cette structure. Définissez avant d’appeler StorPortLogSystemEvent.

Flags

Pas utilisé pour l'instant. Doit être zéro.

EventAssociation

Spécifie si l’événement doit être associé à l’adaptateur, à la cible ou à la LUN. Pour les événements associés à l’adaptateur et à la cible, l’événement est enregistré sur l’objet d’appareil de l’adaptateur. Pour les événements associés à une LUN, l’événement est consigné dans l’objet d’appareil de la LUN s’il existe ; sinon, il est journalisé sur l’objet d’appareil de l’adaptateur.

PathId

Chemin/bus SCSI correspondant à cet événement.

TargetId

Le contrôleur cible SCSI ou l’appareil sur le bus correspondant à cet événement.

LunId

Numéro d’unité logique SCSI de l’appareil cible correspondant à cet événement.

StorportSpecificErrorCode

Si la valeur ErrorCode est spécifique à Storport et doit être traduite pour être utilisée avec IOLOGMSG.DLL, cette valeur est définie sur TRUE. Si la valeur ErrorCode n’est pas spécifique à Storport et doit être transmise directement à la fonctionnalité de journalisation des événements système, cette valeur est définie sur FALSE.

ErrorCode

Code d’erreur d’événement à journaliser.

UniqueId

Spécifie un identificateur unique associé au code d’erreur. Il est souvent utilisé comme code d’emplacement, référençant l’emplacement dans le miniport qui a déclenché l’événement. Cette valeur est transmise directement à la fonctionnalité de journalisation des événements.

DumpDataSize

Taille du bloc de données spécifique au miniport qui doit être ajouté à l’entrée du journal. Si aucun bloc de données ne doit être écrit, il doit être défini sur 0.

DumpData

Pointeur vers le bloc de données spécifique au miniport qui doit être ajouté à l’entrée du journal. Si aucun bloc de données ne doit être écrit, DumpDataSize doit être défini sur 0, et ce champ est ignoré.

StringCount

Nombre de chaînes Unicode terminées par null contenues dans le membre StringList. Si aucune chaîne ne doit être écrite, cette valeur doit être définie sur 0.

StringList

Liste des chaînes Unicode terminées par null à ajouter à l’entrée du journal pour une utilisation en substitution de chaîne. Ces chaînes sont remplacées par les espaces réservés « %2 » à « %n » dans le texte du message du journal lorsque l’entrée du journal est affichée. Cette liste se compose d’un tableau de pointeurs vers les chaînes Unicode terminées par null. StringCount contient le nombre de pointeurs de chaîne dans ce tableau, donc aucune entrée d’arrêt de liste n’est nécessaire. Si aucune chaîne ne doit être écrite, StringCount doit être défini sur 0, et ce champ est ignoré.

Remarques

Bien que StorPortLogError utilise des valeurs PathId, TargetId et LunId de 8 bits de large, pour StorPortLogSystemEvent , elles ont une largeur de 32 bits. La taille combinée des données de vidage et des zones de chaîne du pilote miniport ne peut pas dépasser 150 octets. Cette restriction est due à la < limite de 255 octets que le noyau applique aux entrées du journal des événements.

Configuration requise

Condition requise	Valeur
En-tête	storport.h (inclure Storport.h)

Voir aussi

STOR_EVENT_ASSOCIATION_ENUM

StorPortLogSystemEvent

Partager via