(storport.h) PORT_CONFIGURATION_INFORMATION 结构

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

AdapterInterfaceType

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

BusInterruptLevel

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

BusInterruptVector

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

InterruptMode

指定 HBA 是使用 LevelSensitive 还是闩锁 (有时称为“边缘触发”) 中断。 Storport 将此成员初始化为总线和设备的适当值，例如 PCIBus 的 LevelSensitive。 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 确定的特定值 () ，则微型端口驱动程序可以分配默认值。否则，微型端口驱动程序应尽可能使用端口驱动程序分配的任何非零值。通常，此值由 为 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，微型端口驱动程序必须根据 HBA 的要求将虚拟地址转换为物理地址。 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