PORT_CONFIGURATION_INFORMATION结构（storport.h）

2025-02-07

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 连接到的 I/O 总线数。微型端口驱动程序不得修改此成员。其值是系统分配的，因为平台可能有多个指定的 AdapterInterfaceTypeI/O 总线。

AdapterInterfaceType

I/O 总线接口。 Storport 将此成员初始化为 HW_INITIALIZATION_DATA 结构中微型端口驱动程序指定的值。微型端口驱动程序不得修改此成员。

BusInterruptLevel

总线相对中断请求级别。 Storport 不假设 HBA 的中断使用情况，因此默认值为零。 Storport 初始化此成员，微型端口驱动程序不得对其进行修改。

BusInterruptVector

HBA 返回的相对于总线的向量。 Storport 不假设 HBA 的中断使用情况，因此默认值为零。此成员与为其 HBA 设置 BusInterruptLevel 成员的驱动程序无关。它适用于使用中断矢量的 I/O 总线类型的 HBA，例如 PCIBus。 Storport 初始化此成员，微型端口驱动程序不得对其进行修改。

InterruptMode

指定 HBA 是使用 LevelSensitive 还是闩锁（有时称为“边缘触发”）中断。 Storport 将此成员初始化为总线和设备的相应值，例如，PCIBusLevelSensitive。 Storport 初始化此成员，微型端口驱动程序不得对其进行修改。

MaximumTransferLength

HBA 可以在单个传输作中传输的最大字节数。默认情况下，此成员的值SP_UNINITIALIZED_VALUE，表示最大传输大小不受限制。如果 HBA 的传输支持有限，微型端口驱动程序必须根据 HBA 的传输容量重置此成员。如果微型端口驱动程序的 HwStorInterrupt 例程无法禁用 HBA 上的中断，则可以在驱动程序开发期间调整此成员，以确保在该微型端口驱动程序的 ISR 中花费的时间不会降低整体系统性能。

NumberOfPhysicalBreaks

存储适配器可以在单个传输中管理的最大物理页数（换句话说，其散点/收集支持的范围）。默认情况下，此成员的值0x11。微型端口驱动程序必须根据存储适配器的功能重置此成员。

DmaChannel

从属 HBA 使用的 DMA 通道。默认情况下，此成员的值SP_UNINITIALIZED_VALUE。 Storport 初始化此成员，微型端口驱动程序不得对其进行修改。

DmaPort

从属 HBA 使用的 DMA 端口。默认情况下，此成员的值SP_UNINITIALIZED_VALUE。 Storport 初始化此成员，微型端口驱动程序不得对其进行修改。

DmaWidth

如果 HBA 使用 DMA，则 DMA 传输的宽度。默认情况下，此成员的值为零。 Storport 初始化此成员，微型端口驱动程序不得对其进行修改。

DmaSpeed

Eisa HBA 的 DMA 数据传输速度。 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]

发起程序总线 ID。如果输入 InitiatorBusId[0] 具有值SP_UNINITIALIZED_VALUE，则微型端口驱动程序在 HBA 不需要使用通过查询 HBA 确定的特定值时可以分配默认值。否则，微型端口驱动程序应尽可能使用端口驱动程序分配的任何非零值。通常，此值由为 MaximumNumberOfTargets设置的值绑定。

ScatterGather

当 TRUE时，HBA 支持散点/收集。 Storport 将此成员初始化为 TRUE，因为它的微型端口驱动程序必须支持散点/收集。使用 Storport 的微型端口驱动程序不得修改此值。（注意：在 Windows Server 2008 R2 和 Windows 7 之前的 Windows 版本中，此成员设置为 FALSE。在这种情况下，微型端口驱动程序必须将此成员设置为 TRUE。未将此成员设置为 TRUE 将导致 HBA 设备无法启动。

Master

当 TRUE时，HBA 是主总线。 Storport 将此成员初始化为 TRUE，因为它的微型端口驱动程序必须支持总线主控 DMA。使用 Storport 的微型端口驱动程序不得修改此值。（注意：在 Windows Server 2008 R2 和 Windows 7 之前的 Windows 版本中，此成员设置为 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。微型端口驱动程序不得修改此值，因为如果未设置 Dma64BitAddresses 的值，则这是默认的 DMA 寻址。注意：如果设备硬件仅支持 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	映射除读取和写入请求之外的所有 IO 的缓冲区。
STOR_MAP_ALL_BUFFERS_INCLUDING_READ_WRITE	映射所有 IO 的缓冲区，包括读取和写入请求。支持启动的微型端口必须处理长度PAGE_SIZE的读取或写入请求。这些读取或写入请求必须始终成功完成。 Storport 可能无法在低系统内存条件下映射缓冲区。在这种情况下，SRB 中的 DataBuffer 成员将为 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

要发送到微型端口驱动程序的 SRB 的类型。从 Windows 8 开始可用。此值设置为以下值之一：

价值	意义
SRB_TYPE_SCSI_REQUEST_BLOCK	微型端口驱动程序接收标准 SRB。
SRB_TYPE_STORAGE_REQUEST_BLOCK	微型端口驱动程序接收扩展的 SRB。

AddressType

Storport 和微型端口驱动程序之间使用的地址类型。从 Windows 8 开始可用。这可以设置为以下值：

价值	意义
STORAGE_ADDRESS_TYPE_BTL8	总线、目标和 LUN （BTL） 8 位寻址。

ReservedUchars[2]

保留供系统使用（Windows 8 前）。

SlotNumber