PORT_CONFIGURATION_INFORMATION 結構 (storport.h)

發行項
02/29/2024

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 的中斷使用方式，因此預設值為零。此成員與設定 BusInterruptLevel 成員為其 HBA 的驅動程序無關。這與使用插斷向量之 I/O 總線類型的 HBA 相關，例如 PCIBus。 Storport 會初始化這個成員，而迷你埠驅動程式不得加以修改。

InterruptMode

指定 HBA 是否使用 LevelSensitive 或 Latched (有時稱為「邊緣觸發」) 中斷。 Storport 會將這個成員初始化為總線的適當值，例如 ，LevelSensitive for PCIBus。 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]

啟動器總線標識碼。如果輸入 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，因為其迷你埠驅動程式必須支援散佈/收集清單。 Miniport 不得修改此值。

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