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 が接続されている I/O バスのシステム割り当て番号。ミニポートドライバーは、このメンバーを変更することはできません。プラットフォームには、指定された AdapterInterfaceType の I/O バスが複数ある可能性があるため、その値はシステム割り当てです。

AdapterInterfaceType

I/O バスインターフェイス。 Storport は、このメンバーを 、HW_INITIALIZATION_DATA 構造体のミニポートドライバーによって指定された値に初期化します。ミニポートドライバーは、このメンバーを変更することはできません。

BusInterruptLevel

バス相対割り込み要求レベル。 Storport では、HBA の割り込み使用量に関する想定は行われません。そのため、既定値は 0 です。 Storport は、このメンバーを初期化し、ミニポートドライバーは変更できません。

BusInterruptVector

HBA によって返されるバス相対ベクトル。 Storport では、HBA の割り込み使用量に関する想定は行われません。そのため、既定値は 0 です。このメンバーは、HBA の BusInterruptLevel メンバーを設定するドライバーとは無関係です。これは、 PCIBus などの割り込みベクトルを使用する I/O バスの種類の HBA に関連します。 Storport は、このメンバーを初期化し、ミニポートドライバーは変更できません。

InterruptMode

HBA で LevelSensitive または Latched ("エッジトリガー" と呼ばれることもあります) 割り込みを使用するかどうかを指定します。 Storport は、このメンバーをバスとデバイスの適切な値 (PCIBus の LevelSensitive など) に初期化します。 Storport は、このメンバーを初期化し、ミニポートドライバーは変更できません。

MaximumTransferLength

HBA が 1 回の転送操作で転送できる最大バイト数。既定では、このメンバーの値はSP_UNINITIALIZED_VALUEです。これは、無制限の最大転送サイズを示します。 HBA の転送サポートが制限されている場合、ミニポートドライバーは HBA の転送容量に従ってこのメンバーをリセットする必要があります。ミニポートドライバーの HwStorInterrupt ルーチンで HBA の割り込みを無効にできない場合、このメンバーはドライバーの開発中に調整して、そのミニポートドライバーの ISR に費やされた時間がシステムの全体的なパフォーマンスを低下させないようにすることができます。

NumberOfPhysicalBreaks

記憶域アダプターが 1 回の転送で管理できる物理ページの最大数 (つまり、散布/収集サポートの範囲)。既定では、このメンバーの値は0x11。ミニポートドライバーは、記憶域アダプターの機能に従ってこのメンバーをリセットする必要があります。

DmaChannel

下位 HBA によって使用される DMA チャネル。既定では、このメンバーの値はSP_UNINITIALIZED_VALUE。 Storport は、このメンバーを初期化し、ミニポートドライバーは変更できません。

DmaPort

下位 HBA によって使用される DMA ポート。既定では、このメンバーの値はSP_UNINITIALIZED_VALUE。 Storport は、このメンバーを初期化し、ミニポートドライバーは変更できません。

DmaWidth

HBA で DMA が使用されている場合の DMA 転送の幅。既定では、このメンバーの値は 0 です。 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

アダプターによって制御されるバスの数。既定では、このメンバーの値は 0 です。このメンバーの最大値は SCSI_MAXIMUM_BUSES_PER_ADAPTER です。このメンバーは、Windows 8 以降で使用できます。

InitiatorBusId[8]

イニシエーターバス ID。入力 InitiatorBusId[0] の 値がSP_UNINITIALIZED_VALUE場合、ミニポートドライバーは、HBA が HBA のクエリによって決定された特定の値の使用を必要としない場合に既定値を割り当てることができます。それ以外の場合、ミニポートドライバーは、可能であれば、ポートドライバーによって割り当てられた 0 以外の値を使用する必要があります。通常、この値は MaximumNumberOfTargets に設定された値によってバインドされます。

ScatterGather

TRUE の場合、HBA は散布/収集をサポートします。 Storport は、ミニポートドライバーが散布/収集をサポートする必要があるため 、このメンバーを TRUE に 初期化します。 Storport で動作するミニポートドライバーは、この値を変更しないでください。 (注: Windows Server 2008 R2 および Windows 7 より前のバージョンの Windows では、このメンバーは FALSE に設定されています。この場合、ミニポートドライバーは、このメンバーを TRUE に設定する必要があります。このメンバーを TRUE に設定しないと、HBA デバイスの起動に失敗します)。

Master

TRUE の場合、HBA はマスターバスです。 Storport は、ミニポートドライバーがバスマスタリング DMA をサポートする必要があるため 、このメンバーを TRUE に 初期化します。 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 は、ミニポートドライバーがバス幅 DMA をサポートする必要があるため、このメンバーを TRUE に初期化します。 Dma64BitAddresses の値が設定されていない場合、これは既定の DMA アドレス指定であるため、ミニポートドライバーはこの値を変更しないでください。注: デバイスハードウェアで 32 ビットアドレスのみがサポートされている場合は、 Dma64BitAddresses を 0 に設定する必要があります。

DemandMode

システム DMA コントローラーを単一サイクル操作ではなく、需要モード用にプログラムする必要があるかどうかを示します。 Storport は、下位モード DMA をサポートしていないため、このメンバーを FALSE に初期化します。ミニポートドライバーは、この値を変更することはできません。

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