VIRTUAL_HW_INITIALIZATION_DATA 構造体 (storport.h)

[アーティクル]
08/07/2023

VIRTUAL_HW_INITIALIZATION_DATA構造体には、各仮想ミニポートドライバーに特有の情報が含まれています。

構文

typedef struct _VIRTUAL_HW_INITIALIZATION_DATA {
  ULONG                       HwInitializationDataSize;
  INTERFACE_TYPE              AdapterInterfaceType;
  PHW_INITIALIZE              HwInitialize;
  PHW_STARTIO                 HwStartIo;
  PHW_INTERRUPT               HwInterrupt;
  PVIRTUAL_HW_FIND_ADAPTER    HwFindAdapter;
  PHW_RESET_BUS               HwResetBus;
  PHW_DMA_STARTED             HwDmaStarted;
  PHW_ADAPTER_STATE           HwAdapterState;
  ULONG                       DeviceExtensionSize;
  ULONG                       SpecificLuExtensionSize;
  ULONG                       SrbExtensionSize;
  ULONG                       NumberOfAccessRanges;
  PVOID                       Reserved;
  UCHAR                       MapBuffers;
  BOOLEAN                     NeedPhysicalAddresses;
  BOOLEAN                     TaggedQueuing;
  BOOLEAN                     AutoRequestSense;
  BOOLEAN                     MultipleRequestPerLu;
  BOOLEAN                     ReceiveEvent;
  USHORT                      VendorIdLength;
  PVOID                       VendorId;
  union {
    USHORT ReservedUshort;
    USHORT PortVersionFlags;
  };
  USHORT                      DeviceIdLength;
  PVOID                       DeviceId;
  PHW_ADAPTER_CONTROL         HwAdapterControl;
  PHW_BUILDIO                 HwBuildIo;
  PHW_FREE_ADAPTER_RESOURCES  HwFreeAdapterResources;
  PHW_PROCESS_SERVICE_REQUEST HwProcessServiceRequest;
  PHW_COMPLETE_SERVICE_IRP    HwCompleteServiceIrp;
  PHW_INITIALIZE_TRACING      HwInitializeTracing;
  PHW_CLEANUP_TRACING         HwCleanupTracing;
} VIRTUAL_HW_INITIALIZATION_DATA, *PVIRTUAL_HW_INITIALIZATION_DATA;

メンバー

HwInitializationDataSize

sizeof() によって返されるこの構造体のサイズをバイト単位で指定します。このメンバーは、仮想ミニポートドライバーによって使用されるこの構造体のバージョンを示します。仮想ミニポートドライバーの DriverEntry ルーチンは、ポートドライバーのこのメンバーの値を設定する必要があります。

AdapterInterfaceType

Storport 仮想ミニポートドライバーの場合、 AdapterInterfaceType の値はほとんどの場合内部になります。これは、Storport ドライバーがレガシバスをサポートしていないためです。

このため、SCSI ポートドライバーで使用されるアダプターインターフェイスの種類のほとんどは、Storport ドライバーでは無効であることに注意してください。特に、Storport では次の機能はサポートされていません。

Isa
Eisa
MicroChannel
TurboChannel

さらに、SCSI ポートの場合とは異なり、Storport ドライバーで動作する仮想ミニポートドライバーは、次のメンバーの値を指定する必要はありません。

VendorIdLength
VendorId
DeviceIdLength
DeviceId

HwInitialize

仮想ミニポートドライバーの HwStorInitialize ルーチンへのポインター。これは、すべての仮想ミニポートドライバーに必要なエントリポイントです。

HwStartIo

すべての仮想ミニポートドライバーに必要なエントリポイントである、仮想ミニポートドライバーの HwStorStartIo ルーチンへのポインター。

HwInterrupt

使用されていません。仮想ミニポートドライバーは、割り込みを処理しません。

HwFindAdapter

すべての仮想ミニポートドライバーに必要なエントリポイントである仮想ミニポートドライバーの VirtualHwStorFindAdapter ルーチンへのポインター。

HwResetBus

仮想ミニポートドライバーの HwStorResetBus ルーチンへのポインター。これは、すべての仮想ミニポートドライバーに必要なエントリポイントです。

HwDmaStarted

使用されていません。仮想ミニポートドライバーは DMA を実行しません。

HwAdapterState

Storport ドライバーでは、レガシドライバーはサポートされていません。したがって、このメンバーは NULL である必要があります。

DeviceExtensionSize

アダプターごとの非ページデバイス拡張機能の仮想ミニポートドライバーに必要なサイズ (バイト単位) を指定します。仮想ミニポートドライバーは、ドライバーによって決定されたアダプター情報の記憶域として、そのデバイス拡張機能を使用します。オペレーティングシステム固有のポートドライバーは、割り当てる各デバイス拡張機能をゼロで初期化し、仮想ミニポートドライバーのほとんどの呼び出しでアダプター固有のデバイス拡張機能へのポインターを渡します。指定されたサイズには、仮想ミニポートドライバーが要求した論理ユニットごとの記憶域は含まれません。

SpecificLuExtensionSize

仮想ミニポートドライバーが論理ユニットごとの非ページ記憶域に必要なサイズ (バイト単位) を指定します (存在する場合)。仮想ミニポートドライバーは、仮想バス上の周辺機器に関するドライバーによって決定された LU 情報の記憶域として、その論理ユニット (LU) 拡張機能を使用できます。オペレーティングシステム固有のポートドライバーは、割り当てる各 LU 拡張機能をゼロで初期化します。仮想ミニポートドライバーがストレージを必要とする LU ごとの情報を保持しない場合は、このメンバーを 0 のままにします。

SrbExtensionSize

要求ごとの非ページ記憶域に仮想ミニポートドライバーが必要とするサイズ (バイト単位) を指定します (存在する場合)。 Storport ドライバーで動作する仮想ミニポートドライバーは、散布図/収集リストをサポートする必要があり、SRB ごとの散布/収集リストは通常、SRB 拡張機能で割り当てられるため、このメンバーはめったにゼロではありません。

NumberOfAccessRanges

使用されていません。仮想ミニポートドライバーは、ハードウェアをサポートしていません。

Reserved

システムで使用するために予約されています。

MapBuffers

名前	説明
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 要求のバッファーをマップします。ミニポートドライバーは通常、この設定を使用します。