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 バスのシステム割り当て番号。ミニポートドライバーは、このメンバーを変更できません。プラットフォームには、指定された 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 使用するか、ラッチされた ("エッジトリガー" とも呼ばれる) 割り込みを 使用するかを指定します。 Storport は、バスとデバイスの適切な値にこのメンバーを初期化します。たとえば、PCIBus のLevelSensitive します。 Storport は、このメンバーを初期化し、ミニポートドライバーは変更しないでください。

MaximumTransferLength

1 回の転送操作で HBA が転送できる最大バイト数。既定では、このメンバーの値は 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-type 要素の配列へのポインター。 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