Initialization of Storport Virtual Miniport drivers
The Storport Virtual Miniport driver has three stages of initialization. In the first stage, a miniport calls the
StorPortInitialize routine by pointing to a
VIRTUAL_HW_INITIALIZATION_DATA structure.
Storport Virtual Miniport routines
Storport Virtual Miniport drivers and Storport physical miniport drivers are equivalent in many ways. A physical miniport uses a physical host bus adapter (HBA). A virtual miniport differs from a physical miniport primarily in that the virtual miniport tells the Storport driver to assume that the miniport controls no hardware. In this case, the Storport driver does not obtain a direct memory access (DMA) object. Therefore, the Storport driver does not obtain an interrupt object, an interrupt lock, or non-cached storage.
Another obvious difference is that a virtual miniport can use all APIs that are documented in the Microsoft Windows Driver Kit (WDK). A physical miniport is expected to use only Storport APIs. However, a virtual miniport may also use other APIs. For example, a virtual miniport may also use the APIs that the system kernel provides, assuming the virtual miniport complies with the restrictions that apply to WDM drivers.
For more information about Storport support routines, visit the following Microsoft Developer Network Web site:
For information about other kernel APIs, see the description of the relevant APIs in the WDK.
Storport Virtual Miniport driver structures
The
VIRTUAL_HW_INITIALIZATION_DATA structure contains information that is specific to each virtual miniport driver. This structure is defined as follows:
typedef struct _VIRTUAL_HW_INITIALIZATION_DATA {
ULONG HwInitializationDataSize;
INTERFACE_TYPE AdapterInterfaceType;
PHW_INITIALIZE HwInitialize;
PHW_STARTIO HwStartIo;
PHW_INTERRUPT HwInterrupt;
PVIRTUL_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;
Virtual miniport I/O control codes
Virtual miniport clients use the
IOCTL_MINIPORT_PROCESS_SERVICE_IRP I/O control code to communicate with a virtual miniport.
Update information
The following files are available for download from the Microsoft Download Center:
Windows Server 2003, x86-based versions
Download the Windows Server 2003, x86-based package now.Windows Server 2003, Itanium-based versions
Download the Windows Server 2003, Itanium-based package now.Windows Server 2003, x64-based versions
Download the Windows Server 2003, x64-based package now.For more information about how to download Microsoft support files, click the following article number to view the article in the Microsoft Knowledge Base:
119591 How to obtain Microsoft support files from online services
Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help prevent any unauthorized changes to the file.
Prerequisites
To apply this update, you must have Windows Server 2003 SP1 or Windows Server 2003 Service Pack 2 (SP2) installed.
For more information, click the following article number to view the article in the Microsoft Knowledge Base:
889100 How to obtain the latest service pack for Windows Server 2003
Restart requirement
You must restart the computer after you apply this update.
Update replacement information
This update does not replace any other updates.
File information
The English version of this update has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.Windows Server 2003, x86-based versions
| File name | File version | File size | Date | Time | Platform | SP requirement | Service branch |
|---|
| Diskdump.sys | 5.2.3790.3019 | 18,944 | 04-Oct-2007 | 18:52 | x86 | SP1 | SP1QFE |
| Storport.sys | 5.2.3790.3019 | 108,032 | 04-Oct-2007 | 18:52 | x86 | SP1 | SP1QFE |
| Diskdump.sys | 5.2.3790.4163 | 18,944 | 04-Oct-2007 | 12:35 | x86 | SP2 | SP2GDR |
| Storport.sys | 5.2.3790.4163 | 108,032 | 04-Oct-2007 | 12:35 | x86 | SP2 | SP2GDR |
| Diskdump.sys | 5.2.3790.4163 | 18,944 | 04-Oct-2007 | 15:39 | x86 | SP2 | SP2QFE |
| Storport.sys | 5.2.3790.4163 | 108,032 | 04-Oct-2007 | 15:39 | x86 | SP2 | SP2QFE |
Windows Server 2003, Itanium-based versions
| File name | File version | File size | Date | Time | Platform | SP requirement | Service branch |
|---|
| Diskdump.sys | 5.2.3790.3019 | 49,664 | 05-Oct-2007 | 15:05 | IA-64 | SP1 | SP1QFE |
| Storport.sys | 5.2.3790.3019 | 347,136 | 05-Oct-2007 | 15:05 | IA-64 | SP1 | SP1QFE |
| Diskdump.sys | 5.2.3790.4163 | 49,664 | 05-Oct-2007 | 15:15 | IA-64 | SP2 | SP2GDR |
| Storport.sys | 5.2.3790.4163 | 347,136 | 05-Oct-2007 | 15:15 | IA-64 | SP2 | SP2GDR |
| Diskdump.sys | 5.2.3790.4163 | 49,664 | 05-Oct-2007 | 15:05 | IA-64 | SP2 | SP2QFE |
| Storport.sys | 5.2.3790.4163 | 347,136 | 05-Oct-2007 | 15:05 | IA-64 | SP2 | SP2QFE |
Windows Server 2003, x64-based versions
| File name | File version | File size | Date | Time | Platform | SP requirement | Service branch |
|---|
| Diskdump.sys | 5.2.3790.3019 | 24,064 | 05-Oct-2007 | 15:04 | x64 | SP1 | SP1QFE |
| Storport.sys | 5.2.3790.3019 | 188,416 | 05-Oct-2007 | 15:04 | x64 | SP1 | SP1QFE |
| Diskdump.sys | 5.2.3790.4163 | 24,064 | 05-Oct-2007 | 15:14 | x64 | SP2 | SP2GDR |
| Storport.sys | 5.2.3790.4163 | 188,928 | 05-Oct-2007 | 15:14 | x64 | SP2 | SP2GDR |
| Diskdump.sys | 5.2.3790.4163 | 24,064 | 05-Oct-2007 | 15:05 | x64 | SP2 | SP2QFE |
| Storport.sys | 5.2.3790.4163 | 188,928 | 05-Oct-2007 | 15:05 | x64 | SP2 | SP2QFE |