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

The Storport driver does not support legacy buses. Therefore, 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, and TurboChannel. Furthermore, unlike the SCSI port case, a virtual miniport driver that works with the Storport driver is not required to supply values for the VendorIdLength, VendorId, DeviceIdLength, and DeviceId members.

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

Not valid for virtual miniport drivers. The virtual miniport driver must map all data buffers into virtual address space.

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

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

VendorIdLength

The length, in bytes, of the vendor identifier.

VendorId

The vendor identifier.

ReservedUshort

Reserved.

PortVersionFlags

A bitmap of flags that indicate the features that the port driver supports. Currently, the only flag available is SP_VER_TRACE_SUPPORT, which indicates that the port driver supports tracing.

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

 

 

Send comments about this topic to Microsoft

Show: