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

Статья
08/07/2023

PORT_CONFIGURATION_INFORMATION содержит сведения о конфигурации адаптера шины узла (HBA).

Синтаксис

typedef struct _PORT_CONFIGURATION_INFORMATION {
  ULONG                                  Length;
  ULONG                                  SystemIoBusNumber;
  INTERFACE_TYPE                         AdapterInterfaceType;
  ULONG                                  BusInterruptLevel;
  ULONG                                  BusInterruptVector;
  KINTERRUPT_MODE                        InterruptMode;
  ULONG                                  MaximumTransferLength;
  ULONG                                  NumberOfPhysicalBreaks;
  ULONG                                  DmaChannel;
  ULONG                                  DmaPort;
  DMA_WIDTH                              DmaWidth;
  DMA_SPEED                              DmaSpeed;
  ULONG                                  AlignmentMask;
  ULONG                                  NumberOfAccessRanges;
  ACCESS_RANGE( )                          *AccessRanges[];
  PVOID                                  MiniportDumpData;
  PVOID                                  Reserved;
  UCHAR                                  NumberOfBuses;
  CCHAR                                  InitiatorBusId[8];
  BOOLEAN                                ScatterGather;
  BOOLEAN                                Master;
  BOOLEAN                                CachesData;
  BOOLEAN                                AdapterScansDown;
  BOOLEAN                                AtdiskPrimaryClaimed;
  BOOLEAN                                AtdiskSecondaryClaimed;
  BOOLEAN                                Dma32BitAddresses;
  BOOLEAN                                DemandMode;
  UCHAR                                  MapBuffers;
  BOOLEAN                                NeedPhysicalAddresses;
  BOOLEAN                                TaggedQueuing;
  BOOLEAN                                AutoRequestSense;
  BOOLEAN                                MultipleRequestPerLu;
  BOOLEAN                                ReceiveEvent;
  BOOLEAN                                RealModeInitialized;
  BOOLEAN                                BufferAccessScsiPortControlled;
  UCHAR                                  MaximumNumberOfTargets;
  UCHAR                                  SrbType;
  UCHAR                                  AddressType;
  UCHAR                                  ReservedUchars[2];
  ULONG                                  SlotNumber;
  ULONG                                  BusInterruptLevel2;
  ULONG                                  BusInterruptVector2;
  KINTERRUPT_MODE                        InterruptMode2;
  ULONG                                  DmaChannel2;
  ULONG                                  DmaPort2;
  DMA_WIDTH                              DmaWidth2;
  DMA_SPEED                              DmaSpeed2;
  ULONG                                  DeviceExtensionSize;
  ULONG                                  SpecificLuExtensionSize;
  ULONG                                  SrbExtensionSize;
  UCHAR                                  Dma64BitAddresses;
  BOOLEAN                                ResetTargetSupported;
  UCHAR                                  MaximumNumberOfLogicalUnits;
  BOOLEAN                                WmiDataProvider;
  STOR_SYNCHRONIZATION_MODEL             SynchronizationModel;
  PHW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE HwMSInterruptRoutine;
  INTERRUPT_SYNCHRONIZATION_MODE         InterruptSynchronizationMode;
  MEMORY_REGION                          DumpRegion;
  ULONG                                  RequestedDumpBufferSize;
  BOOLEAN                                VirtualDevice;
  UCHAR                                  DumpMode;
  UCHAR                                  DmaAddressWidth;
  ULONG                                  ExtendedFlags1;
  ULONG                                  MaxNumberOfIO;
  ULONG                                  MaxIOsPerLun;
  ULONG                                  InitialLunQueueDepth;
  ULONG                                  BusResetHoldTime;
  ULONG                                  FeatureSupport;
} PORT_CONFIGURATION_INFORMATION, *PPORT_CONFIGURATION_INFORMATION;

Члены

Length

Размер структуры PORT_CONFIGURATION_INFORMATION в байтах. Инициализированный драйвером Storport, этот элемент также служит версией структуры.

SystemIoBusNumber

Назначенный системой номер шины ввода-вывода, к которой подключен адаптер HBA. Драйверы мини-порта не должны изменять этот элемент. Его значение назначается системой, так как платформа может иметь несколько шин ввода-вывода указанного AdapterInterfaceType.

AdapterInterfaceType

Интерфейс шины ввода-вывода. Storport инициализирует этот элемент значением, указанным драйвером мини-порта в структуре HW_INITIALIZATION_DATA . Драйверы мини-порта не должны изменять этот элемент.

BusInterruptLevel

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

BusInterruptVector

Относительный вектор шины, возвращаемый HBA. Storport не делает никаких предположений об использовании прерываний HBA, поэтому значение по умолчанию равно нулю. Этот элемент не имеет отношения к драйверам, которые настраивают член BusInterruptLevel для своих HBA. Это уместно для HBA на типах шин ввода-вывода, использующих векторы прерываний, такие как PCIBus. Storport инициализирует этот элемент, и драйверы мини-порта не должны изменять его.

InterruptMode

Указывает, использует ли HBA прерывания LevelSensitive или Latched (иногда называемые "триггером ребра"). Storport инициализирует этот элемент соответствующим значением для шины и устройства, например LevelSensitive для PCIBus. Storport инициализирует этот элемент, и драйверы мини-порта не должны изменять его.

MaximumTransferLength

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

NumberOfPhysicalBreaks

Максимальное количество физических страниц, которыми адаптер хранилища может управлять за одну передачу (другими словами, степень поддержки точечной и сборной). По умолчанию значение этого элемента равно 0x11. Драйвер мини-порта должен сбросить этот элемент в соответствии с возможностями адаптера хранилища.

DmaChannel

Канал DMA, используемый подчиненным адаптером HBA. По умолчанию значение этого элемента равно SP_UNINITIALIZED_VALUE. Storport инициализирует этот элемент, и драйверы мини-порта не должны изменять его.

DmaPort

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

DmaWidth

Ширина передачи DMA, если HBA использует DMA. По умолчанию значение этого элемента равно нулю. Storport инициализирует этот элемент, и драйверы мини-порта не должны изменять его.

DmaSpeed

Скорость передачи данных DMA для Eisa HBA. Storport инициализирует этот элемент, и драйверы мини-порта не должны изменять его.

AlignmentMask

Маска, указывающая ограничения выравнивания для буферов, необходимых адаптеру HBA для операций передачи. Некоторые примеры допустимых значений маски: 0 (выравнивание по байтам), 1 (выравнивание по словам), 3 (выравнивание по DWORD) и 7 (двойное выравнивание DWORD). Драйвер мини-порта должен установить эту маску, если HBA поддерживает точечную и сборную. В wdm.h определены следующие допустимые значения маски выравнивания:

Значение	Значение
FILE_BYTE_ALIGNMENT (0x00000000)	Данные выровнены по байтам (нет требований к выравниванию для устройства)
FILE_WORD_ALIGNMENT (0x00000001)	Данные должны быть выровнены по 2-байтовой границе.
FILE_LONG_ALIGNMENT (0x00000003)	Данные должны быть выровнены по 4-байтовой границе.
FILE_QUAD_ALIGNMENT (0x00000007)	Данные должны быть выровнены по 8-байтовой границе.
FILE_OCTA_ALIGNMENT (0x0000000f)	Данные должны быть выровнены по 16-байтовой границе.
FILE_32_BYTE_ALIGNMENT (0x0000001f)	Данные должны быть выровнены по 32-байтовой границе.
FILE_64_BYTE_ALIGNMENT (0x0000003f)	Данные должны быть выровнены по 64-байтовой границе.
FILE_128_BYTE_ALIGNMENT (0x0000007f)	Данные должны быть выровнены по 128-байтовой границе.
FILE_256_BYTE_ALIGNMENT (0x000000ff)	Данные должны быть выровнены по 256-байтовой границе.
FILE_512_BYTE_ALIGNMENT (0x000001ff)	Данные должны быть выровнены по 512-байтовой границе.

NumberOfAccessRanges

Указывает количество элементов AccessRanges в массиве.

AccessRanges

Указатель на массив элементов ACCESS_RANGE типа. Storport выделяет память для диапазонов доступа и инициализирует этот элемент. Драйверы мини-порта не должны изменять этот элемент.

MiniportDumpData

Указатель на контекст дампа, используемый во время аварийного завершения или гибернации.

Reserved

Зарезервировано для использования системой (предварительно Windows 8).

NumberOfBuses

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

InitiatorBusId[8]

Идентификатор шины инициатора. Если входной элемент InitiatorBusId[0] имеет значение SP_UNINITIALIZED_VALUE, драйвер мини-порта может назначить значение по умолчанию, если его адаптер HBA не требует использования определенных значений, определенных запросом к HBA. В противном случае драйвер мини-порта должен использовать любое ненулевое значение, присвоенное драйвером порта, если это возможно. Как правило, это значение ограничивается значением, заданным для MaximumNumberOfTargets.

ScatterGather

При значении TRUE HBA поддерживает точечную и сборную. Storport инициализирует этот элемент значением TRUE , так как его драйверы мини-порта должны поддерживать точечные и сборные. Драйверы miniport, работающие с Storport, не должны изменять это значение. (Примечание. В версиях Windows до Windows Server 2008 R2 и Windows 7 этот член имеет значение FALSE. В этом случае драйверы мини-порта должны задать для этого элемента значение TRUE. Если не установить для этого члена значение TRUE , устройство HBA не запустится.)

Master

Если задано значение TRUE, HBA является master автобусом. Storport инициализирует этот элемент значением TRUE , так как его драйверы мини-портов должны поддерживать DMA для шины. Драйверы miniport, работающие с Storport, не должны изменять это значение. (Примечание. В версиях Windows до Windows Server 2008 R2 и Windows 7 этот член имеет значение FALSE. В этом случае драйверы мини-порта должны задать для этого элемента значение TRUE. Если не установить для этого члена значение TRUE , устройство HBA не запустится.)

CachesData

При значении TRUE адаптер HBA кэширует данные или сохраняет кэшированное состояние на периферийных устройствах. При значении FALSE адаптер HBA не кэширует данные и не сохраняет кэшированное состояние на периферийных устройствах. По умолчанию этот элемент имеет значение FALSE. Если для этого параметра задано значение TRUE, Storport уведомляет драйвер мини-порта о возникновении определенных системных событий, таких как очистка кэша файловой системы.

AdapterScansDown

Storport игнорирует этот элемент.

AtdiskPrimaryClaimed

Storport не использует этот элемент, и его драйверы мини-портов не должны задавать его.

AtdiskSecondaryClaimed

Storport не использует этот элемент, и его драйверы мини-портов не должны задавать его.

Dma32BitAddresses

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

DemandMode

Указывает, следует ли программировать системный контроллер DMA для работы в режиме по требованию, а не для одноцикловых операций. Storport инициализирует этот элемент значением FALSE, так как он не поддерживает DMA в подчиненном режиме. Драйверы мини-портов не должны изменять это значение.

MapBuffers

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

Значение	Значение
STOR_MAP_NO_BUFFERS	Сопоставляет буфер только для SRB_FUNCTION_IO_CONTROL и SRB_FUNCTION_WMI.
STOR_MAP_ALL_BUFFERS	Является устаревшей. Это значение имеет тот же эффект, что и STOR_MAP_NON_READ_WRITE_BUFFERS.
STOR_MAP_NON_READ_WRITE_BUFFERS	Сопоставляет буфер для всех операций ввода-вывода, кроме запросов на чтение и запись.
STOR_MAP_ALL_BUFFERS_INCLUDING_READ_WRITE	Сопоставляет буфер для всех операций ввода-вывода, включая запросы на чтение и запись. Минипорты, поддерживающие загрузку, должны обрабатывать запросы на чтение или запись PAGE_SIZE длины. Эти запросы на чтение или запись всегда должны выполняться успешно. Storport может не сопоставить буфер при нехватке системной памяти. В этом случае элемент DataBuffer в SRB будет иметь значение NULL.

NeedPhysicalAddresses

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

TaggedQueuing

Если задано значение TRUE, адаптер HBA поддерживает постановку в очередь нескольких запросов с тегами SCSI. Storport инициализирует этот элемент значением TRUE , так как его драйверы мини-портов должны поддерживать добавление тегов в очередь. Драйверы мини-портов не должны изменять это значение.

AutoRequestSense

Если задано значение TRUE, HBA поддерживает автозапрос. Storport инициализирует этот элемент значением TRUE , так как его драйверы мини-порта должны поддерживать функцию автоматического запроса. Драйверы мини-портов не должны изменять это значение.

MultipleRequestPerLu

Если задано значение TRUE, HBA поддерживает несколько запросов на логическую единицу. Storport инициализирует этот элемент значением TRUE , так как его драйверы мини-порта должны поддерживать несколько запросов, выдаваемых в логическую единицу за раз. Драйверы мини-портов не должны изменять это значение.

ReceiveEvent

Storport не использует этот элемент, и его драйверы мини-портов не должны задавать его.

RealModeInitialized

Storport не использует этот элемент, и его драйверы мини-портов не должны задавать его.

BufferAccessScsiPortControlled

Storport не использует этот элемент, и его драйверы мини-портов не должны задавать его.

MaximumNumberOfTargets

Количество целевых периферийных устройств, которые может контролировать адаптер. По умолчанию значение этого элемента равно SCSI_MAXIMUM_TARGETS_PER_BUS. Драйвер мини-порта может сбросить этот элемент на меньшее значение, если HBA имеет более ограниченные возможности или большее значение, указывая, что HBA имеет расширенные возможности шины. Максимальное значение для этого элемента — 255.

SrbType

Тип SDB для отправки драйверу минипорта. Доступно начиная с Windows 8. Для этого параметра задано одно из следующих значений:

Значение	Значение
SRB_TYPE_SCSI_REQUEST_BLOCK	Драйвер мини-порта получает стандартные SРБ.
SRB_TYPE_STORAGE_REQUEST_BLOCK	Драйвер мини-порта получает расширенные SРБ.

AddressType

Тип адреса, используемый между Storport и драйвером мини-порта. Доступно начиная с Windows 8. Для этого параметра можно задать следующее значение:

Значение	Значение
STORAGE_ADDRESS_TYPE_BTL8	8-разрядная адресация шин, целевых и LUN (BTL).

ReservedUchars[2]

Зарезервировано для использования системой (предварительно Windows 8).

SlotNumber