Windows 3.1 Device Drivers (ddag31qh.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
Win386_Startup_Info_Struc
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
Win386_Startup_Info_Struc STRUC
SIS_Version                     db      3, 0
SIS_Next_Dev_Ptr                dd      ?
SIS_Virt_Dev_File_Ptr           dd      0
SIS_Reference_Data              dd      ?
SIS_Instance_Data_Ptr           dd      0
Win386_Startup_Info_Struc ENDS
 
The Win386_Startup_Info_Struc structure contains information that Windows
uses to prepare an MS-DOS device driver or TSR program for operation with
Windows.
 
Member                 Description
────────────────────────────────────────────────────────────────────────────
 
SIS_Version            Specifies the version number of the structure. 386
                       enhanced-mode Windows uses this member to determine
                       the size of the structure. This member should contain
                       3 in the low-order byte and 10 in the high-order byte
                       to indicate that it is version 3.1.
 
SIS_Next_Dev_Ptr       Points to the next structure in the list. The address
                       of the next structure must be supplied by the next
                       handler in the Interrupt 2Fh chain. A driver or TSR
                       calls the next handler, then sets this member to the
                       address returned by the handler in the ES:BX register
                       pair.
 
SIS_Virt_Dev_File_Ptr  Points to a null-terminated string that contains the
                       name of a 386 enhanced-mode Windows virtual device
                       file. MS-DOS devices such as networks use this to
                       force a special 386 enhanced-mode Windows virtual
                       device to be loaded. If this member is zero, no
                       device is loaded.
 
SIS_Reference_Data     Specifies reference data for the virtual device. This
                       member, used only when SIS_Virt_Dev_File_Ptr is
                       nonzero, is passed to the virtual device when it is
                       initialized. The member can contain any value and
                       often contains a pointer to some device-specific
                       structure.
 
SIS_Instance_Data_Ptr  Points to a list of data to be instanced, that is,
                       allocated uniquely for each new virtual machine. If
                       the member is zero, then no data is instanced. Each
                       entry in the list is an Instance_Item_Struc
                       structure. The list is terminated with a 32-bit
                       zero.
 
 
                                      ♦