Using a TSR to Share XMS Memory Between Virtual Machines

Last reviewed: February 15, 1996
Article ID: Q74809
The information in this article applies to:
  • Microsoft Windows Software Development Kit (SDK) for Windows versions 3.0 and 3.1

By using a terminate-and-stay-resident program (TSR) loaded before Windows, programs can share a block of extended memory specification (XMS) memory between virtual machines (VMs).

When the TSR is loaded, it allocates and locks a block of XMS memory. This memory is now global to all VMs. The TSR hooks an interrupt and will return the physical address of the block and the XMS block handle.

A protected-mode Windows program can access the memory directly by converting the physical address returned by the TSR to a linear address using DPMI (the MS-DOS Protected Mode Interface). This linear address can then be used to build a descriptor that references the memory. The descriptor is also built using DPMI.

For the MS-DOS VM to access the XMS block, it must use the XMS block handle returned by the TSR. With this handle, MS-DOS-based applications can copy data to and from the block.

A sample application that demonstrates the techniques outlined above is available in the Software Library in XMSWIN.EXE. A copy of the Microsoft Macro Assembler (MASM) version 5.0 or later is required to build the applications in this file.

Download XMSWIN.EXE, a self-extracting file, from the Microsoft Software Library (MSL) on the following services:

  • Microsoft Download Service (MSDL)

          Dial (206) 936-6735 to connect to MSDL
          Download XMSWIN.EXE (size: 18055 bytes) 
    
  • Internet (anonymous FTP)

          ftp ftp.microsoft.com
          Change to the \SOFTLIB\MSLFILES directory
          Get XMSWIN.EXE (size: 18055 bytes) 
    


Additional reference words: 3.00 3.10 softlib XMSWIN.EXE
KBCategory: kbprg kbfile
KBSubcategory: KrIsrTsr


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: February 15, 1996
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.