структура STOR_LOG_EVENT_DETAILS (storport.h)

Структура STOR_LOG_EVENT_DETAILS содержит подробные сведения о событиях журнала ошибок, относящихся к Storport, и события системного журнала.

Синтаксис

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;

Члены

InterfaceRevision

Номер редакции этого интерфейса. Задайте значение STOR_CURRENT_LOG_INTERFACE_REVISION, чтобы использовать версию интерфейса, соответствующую этой структуре. Константная и структура данных определяются в одном файле заголовка. Для этого элемента задано значение 0x00000100 для первой редакции.

Size

Размер этой структуры. Задайте перед вызовом StorPortLogSystemEvent.

Flags

В настоящий момент не используется. Должен равняться нулю.

EventAssociation

Указывает, должно ли событие быть связано с адаптером, целевым объектом или LUN. Для событий, связанных с адаптером и целевым объектом, событие регистрируется в объекте устройства адаптера. Для событий, связанных с LUN, событие регистрируется в объекте устройства LUN, если оно существует. в противном случае он регистрируется в объекте устройства адаптера.

PathId

Путь или шина SCSI, соответствующая этому событию.

TargetId

Целевой контроллер или устройство SCSI в шине, соответствующее этому событию.

LunId

Номер логической единицы SCSI целевого устройства, соответствующего этому событию.

StorportSpecificErrorCode

Если значение ErrorCode относится к Storport и должно быть преобразовано для использования с IOLOGMSG.DLL, это значение имеет значение TRUE. Если значение ErrorCode не является специфическим для Storport и должно передаваться непосредственно в средство ведения журнала системных событий, то для этого значения устанавливается значение FALSE.

ErrorCode

Код ошибки события для записи в журнал.

UniqueId

Указывает уникальный идентификатор, связанный с кодом ошибки. Часто этот код используется в качестве кода расположения, ссылающегося на расположение в мини-порте, который вызвал событие. Это значение передается непосредственно в средство ведения журнала событий.

DumpDataSize

Размер блока данных для мини-порта, который должен быть добавлен в запись журнала. Если блок данных не должен быть записан, это значение должно быть равно 0.

DumpData

Указатель на блок данных для мини-порта, который должен быть добавлен в запись журнала. Если блок данных не должен быть записан, параметр DumpDataSize должен иметь значение 0, и это поле игнорируется.

StringCount

Количество строк Юникода, заканчивающихся nullом, содержащихся в элементе StringList. Если строки не должны быть записаны, это значение должно быть равным 0.

StringList

Список строк Юникода, заканчивающихся значением NULL, которые будут добавлены в запись журнала для использования при подстановке строк. Эти строки заменяются заполнители "%2" по "%n" в тексте сообщения журнала при отображении записи журнала. Этот список состоит из массива указателей на строки Юникода, завершаемые null. StringCount содержит количество строковых указателей в этом массиве, поэтому запись завершения списка не требуется. Если строки не записываются, значение StringCount должно быть равно 0, и это поле игнорируется.

Комментарии

Хотя StorPortLogError использует значения PathId, TargetId и LunId , которые имеют ширину 8 бит, для StorPortLogSystemEvent они имеют ширину 32 бит. Совокупный размер данных дампа водителя мини-порта и строковых областей не может превышать 150 байт. Это ограничение связано с ограничением в < 255 байт, которое ядро применяет к записям журнала событий.

Требования

Требование	Значение
Заголовок	storport.h (включая Storport.h)

См. также раздел

STOR_EVENT_ASSOCIATION_ENUM

StorPortLogSystemEvent