VIRTUAL_HW_INITIALIZATION_DATA structure

The VIRTUAL_HW_INITIALIZATION_DATA structure contains information particular to each virtual miniport driver.

Syntax

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;

Members

HwInitializationDataSize

Specifies the size of this structure in bytes, as returned by sizeof(). This member indicates the version of this structure that is used by the virtual miniport driver. A virtual miniport driver's DriverEntry routine should set this member's value for the port driver.

AdapterInterfaceType

For storport virtual miniport drivers, the value for AdapterInterfaceType will almost always be internal. This is because the Storport driver does not support legacy buses.

Note that because of this, most of the adapter interface types that are used with the SCSI port driver are invalid for Storport drivers. In particular, Storport does not support:

  • Isa
  • Eisa
  • MicroChannel
  • TurboChannel

Additionally, unlike the SCSI port case, a virtual miniport driver that works with the Storport driver is not required to supply values for the following members:

  • VendorIdLength
  • VendorId
  • DeviceIdLength
  • DeviceId

HwInitialize

A pointer to the virtual miniport driver's HwStorInitialize routine, which is a required entry point for all virtual miniport drivers.

HwStartIo

A pointer to the virtual miniport driver's HwStorStartIo routine, which is a required entry point for all virtual miniport drivers.

HwInterrupt

Not used. Virtual miniport drivers do not process interrupts.

HwFindAdapter

A pointer to the virtual miniport driver's VirtualHwStorFindAdapter routine, which is a required entry point for all virtual miniport drivers.

HwResetBus

A pointer to the virtual miniport driver's HwStorResetBus routine, which is a required entry point for all virtual miniport drivers.

HwDmaStarted

Not used. Virtual miniport drivers do not perform DMA.

HwAdapterState

The Storport driver does not support legacy drivers. Therefore, this member must be NULL.

DeviceExtensionSize

Specifies the size, in bytes, that is required by the virtual miniport driver for its per-adapter non-paged device extension. A virtual miniport driver uses its device extension as storage for driver-determined adapter information. The operating system-specific port driver initializes each device extension that it allocates with zeros, and passes a pointer to the adapter-specific device extension in most calls to the virtual miniport driver. The given size does not include any virtual miniport driver-requested per-logical-unit storage.

SpecificLuExtensionSize

Specifies the size, in bytes, that is required by the virtual miniport driver for its per-logical-unit non-paged storage, if any. A virtual miniport driver can use its logical unit (LU) extensions as storage for driver-determined LU information about peripherals on the virtual bus. The operating system-specific port driver initializes each LU extension that it allocates with zeros. Leave this member set to zero if the virtual miniport driver does not maintain per-LU information for which it requires storage.

SrbExtensionSize

Specifies the size, in bytes, that is required by the virtual miniport driver for its per-request non-paged storage, if any. Because virtual miniport drivers that work with the Storport driver must support scatter/gather lists, and the per-SRB scatter/gather lists are usually allocated in the SRB extension, this member is rarely zero.

NumberOfAccessRanges

Not used. Virtual miniport drivers do not support hardware.

Reserved

Reserved for system use.

MapBuffers

Name Description
STOR_MAP_NO_BUFFERS Only maps buffer for SRB_FUNCTION_IO_CONTROL and SRB_FUNCTION_WMI.
STOR_MAP_ALL_BUFFERS Obsolete, same behavior as STOR_MAP_NON_READ_WRITE_BUFFERS.
STOR_MAP_NON_READ_WRITE_BUFFERS Maps buffer for IO requests except READ and WRITE.
STOR_MAP_ALL_BUFFERS_INCLUDING_READ_WRITE Maps buffer for all IO requests including READ and WRITE. Miniport drivers will typically use this setting.

NeedPhysicalAddresses

Not used. Virtual miniport drivers do not support hardware.

TaggedQueuing

Must be set to TRUE. A value of TRUE indicates that the virtual miniport driver supports tagged queuing.

AutoRequestSense

Must be set to TRUE. A value of TRUE indicates that the HBA can perform a request-sense operation without requiring an explicit request to do so.

MultipleRequestPerLu

Must be set to TRUE. A value of TRUE indicates that the virtual miniport driver can queue multiple requests per logical unit (LU).

ReceiveEvent

This value is no longer used, and can be set to either TRUE or FALSE.

VendorIdLength

The length, in bytes, of the vendor identifier.

VendorId

The vendor identifier.

__unnamed_union_0d83_77

__unnamed_union_0d83_77.ReservedUshort

__unnamed_union_0d83_77.PortVersionFlags

DeviceIdLength

The length, in bytes, of the device identifier.

DeviceId

The device identifier.

HwAdapterControl

A pointer to the virtual miniport driver's HwStorAdapterControl routine.

HwBuildIo

This member is not used.

HwFreeAdapterResources

A pointer to the virtual miniport driver's HwStorFreeAdapterResources routine, which is a required entry point for all virtual miniport drivers.

HwProcessServiceRequest

A pointer to the virtual miniport driver's HwStorProcessServiceRequest routine.

HwCompleteServiceIrp

A pointer to the virtual miniport driver's HwStorCompleteServiceIrp routine.

HwInitializeTracing

A pointer to the virtual miniport driver's HwStorInitializeTracing routine.

HwCleanupTracing

A pointer to the virtual miniport driver's HwStorCleanupTracing routine.

Remarks

If a virtual miniport driver will execute only on Windows 8 or later, the driver should use the HW_INITIALIZATION_DATA structure instead of VIRTUAL_HW_INITIALIZATION_DATA.

Requirements

   
Header storport.h (include Storport.h)

See Also

HwStorAdapterControl

HwStorCleanupTracing

HwStorCompleteServiceIrp

HwStorFreeAdapterResources

HwStorInitialize

HwStorInitializeTracing

HwStorProcessServiceRequest

HwStorResetBus

HwStorStartIo

VirtualHwStorFindAdapter