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

Статья
08/07/2023

Драйвер мини-порта Storport использует эту структуру для поддержки кода функции SCSI_REQUEST_BLOCK (SRB) SRB_FUNCTION_DUMP_POINTERS. Когда драйвер мини-порта получает такой тип SRB, член SRB DataBuffer указывает на MINIPORT_DUMP_POINTERS структуру. Этот SRB отправляется драйверу мини-порта, который используется для управления диском, на котором хранятся данные аварийного дампа после того, как SRB был возвращен из подпрограммы HwStorInitialize драйвера мини-порта. Для поддержки SRB_FUNCTION_DUMP_POINTERS требуются драйверы виртуальных мини-портов.

Синтаксис

typedef struct _MINIPORT_DUMP_POINTERS {
  USHORT                 Version;
  USHORT                 Size;
  WCHAR                  DriverName[DUMP_MINIPORT_NAME_LENGTH];
  struct _ADAPTER_OBJECT *AdapterObject;
  PVOID                  MappedRegisterBase;
  ULONG                  CommonBufferSize;
  PVOID                  MiniportPrivateDumpData;
  ULONG                  SystemIoBusNumber;
  INTERFACE_TYPE         AdapterInterfaceType;
  ULONG                  MaximumTransferLength;
  ULONG                  NumberOfPhysicalBreaks;
  ULONG                  AlignmentMask;
  ULONG                  NumberOfAccessRanges;
  ACCESS_RANGE( )          *AccessRanges[];
  UCHAR                  NumberOfBuses;
  BOOLEAN                Master;
  BOOLEAN                MapBuffers;
  UCHAR                  MaximumNumberOfTargets;
} MINIPORT_DUMP_POINTERS, *PMINIPORT_DUMP_POINTERS;

Члены

Version

Задайте значение DUMP_MINIPORT_VERSION_1.

Size

Задайте для параметра sizeof(MINIPORT_DUMP_POINTERS).

DriverName[DUMP_MINIPORT_NAME_LENGTH]

Широкое имя драйвера мини-порта без сведений о пути (например, Miniport.sys).

AdapterObject

Задайте значение NULL.

MappedRegisterBase

Задайте нулевое значение.

CommonBufferSize

Требуемый размер общего буфера. Размер не должен превышать 64 КБ (65 536 байт).

MiniportPrivateDumpData

Контекст, который передается в подпрограмму HwStorFindAdapter водителя мини-порта во время аварийного дампа. Контекст передается в элемент Reserved или, начиная с Windows 8, элемент MiniportDumpDataструктуры PORT_CONFIGURATION_INFORMATION.

SystemIoBusNumber

Указывает назначаемый системой номер шины ввода-вывода, к которой подключен адаптер HBA. Драйвер Storport инициализирует этот элемент. Драйверы miniport, работающие с драйвером Storport, не должны изменять этот элемент. Дополнительные сведения см. в разделе Элемент SystemIoBusNumberPORT_CONFIGURATION_INFORMATION.

AdapterInterfaceType

Определяет интерфейс шины ввода-вывода. Драйвер Storport инициализирует этот элемент. Драйверы miniport, работающие с драйвером Storport, не должны изменять этот элемент. Дополнительные сведения см. в разделе Элемент AdapterInterfaceTypePORT_CONFIGURATION_INFORMATION.

MaximumTransferLength

Указывает максимальное количество байтов, которые может передавать адаптер HBA за одну операцию передачи в режиме аварийного восстановления. По умолчанию значение этого элемента равно SP_UNINITIALIZED_VALUE, что указывает на неограниченный максимальный размер передачи. Это значение зависит от операции дампа мини-порта и может отличаться от значения в элементе MaximumTransferLengthPORT_CONFIGURATION_INFORMATION.

NumberOfPhysicalBreaks

Указывает максимальное количество разрывов между диапазонами адресов, которое может иметь буфер данных для создания точечных или собираемых списков. Иными словами, количество записей в списке точечной и сборной, которую может поддерживать адаптер, минус одна. Дополнительные сведения см. в разделе Элемент NumberOfPhysicalBreaksPORT_CONFIGURATION_INFORMATION.

AlignmentMask

Содержит маску, указывающую ограничения выравнивания для буферов, необходимых адаптеру HBA для операций передачи. Допустимые значения маски также ограничены характеристиками диспетчеров памяти в разных версиях операционных систем Microsoft Windows. Допустимые значения маски: 0 (выравнивание по байтам), 0x1 (выравнивание по словам), 0x3 (выравнивание DWORD) и 0x7 (двойное выравнивание DWORD). Драйвер мини-порта должен установить эту маску, если HBA поддерживает точечную и сборную. Те же рекомендации относятся к члену AlignmentMaskPORT_CONFIGURATION_INFORMATION.

NumberOfAccessRanges

Указывает количество элементов AccessRanges в массиве. Дополнительные сведения см. в разделе Элемент NumberOfAccessRangesPORT_CONFIGURATION_INFORMATION.

AccessRanges

Указатель на массив элементов ACCESS_RANGE типа. Драйвер Storport инициализирует этот элемент. Драйверы miniport, работающие с драйвером Storport, не должны изменять этот элемент. Дополнительные сведения см. в разделе Элемент AccessRangesPORT_CONFIGURATION_INFORMATION.

NumberOfBuses

Указывает количество автобусов, управляемых адаптером. По умолчанию значение этого элемента равно нулю. Дополнительные сведения см. в разделе Элемент NumberOfBusesPORT_CONFIGURATION_INFORMATION.

Master

При значении TRUE указывает, что HBA является master автобуса. Драйвер Storport инициализирует этот элемент значением TRUE, так как его драйверы мини-порта должны поддерживать DMA для шины. Драйверы мини-портов, работающие с драйвером Storport, не должны изменять это значение. Дополнительные сведения см. в разделе Главный член PORT_CONFIGURATION_INFORMATION.

MapBuffers

Указывает, сопоставляет ли драйвер Storport адреса буфера данных SRB с системными виртуальными адресами. Дополнительные сведения см. в разделе Элемент MapBuffersHW_INITIALIZATION_DATA.

MaximumNumberOfTargets

Указывает количество целевых периферийных устройств, которыми может управлять адаптер. Дополнительные сведения см. в разделе Элемент MaximumNumberOfTargetsPORT_CONFIGURATION_INFORMATION.

Начиная с Windows 8, физические драйверы minport могут дополнительно поддерживать SRB_FUNCTION_DUMP_POINTERS. Если физический мини-порт поддерживает эту функцию, он должен установить флаг STOR_FEATURE_DUMP_POINTERS в элементе FeatureSupport структуры HW_INITIALIZATION_DATA перед вызовом StorPortInitialize. Физические мини-порты требуются для установки по крайней мере элементов Version и SizeMINIPORT_DUMP_POINTERS. Кроме того, если значение отличается от значения, указанного в PORT_CONFIGURATION_INFORMATION, для физического мини-порта требуется член MaximumTransferLength .