Notes on MASM Sample Programs
                     (c) Copyright Microsoft Corp. 1992

==========================================================================
Directory: SAMPLES\32BIT

Contents:  This sample demonstrates how to program for 32-bit operating
           systems such as Windows/NT.  The sample includes a routine
           which searches for a substring within a buffer, using a
           variation of the Boyer-Moore method.

Tools:     Requires MASM 6.1 to assemble.  Linking the resulting .obj to
           create an executable requires a 32-bit operating system and
           software development kit.
--------------------------------------------------------------------------
Directory: SAMPLES\DEMOS

Contents:  This directory includes three separate projects: FileDemo, 
           MathDemo, and MiscDemo.  Each demonstrates the use of assembly
           to perform simple utility functions using DOS and BIOS calls.
--------------------------------------------------------------------------
Directory: SAMPLES\DOSDEV

Contents:  This sample demonstrates construction of a DOS device driver.
           The driver can be used to exchange string data between multiple
           DOS applications, somewhat like the Windows GlobalAtom() API.
           Includes the code for the device driver, an assembly-language
           test program, and a C-language test program.

Tools:     Microsoft C is required to build the C test program.
--------------------------------------------------------------------------
Directory: SAMPLES\MIXED

Contents:  Demonstrates mixed-language programming with MASM and FORTRAN,
           BASIC, and C.

Tools:     A FORTRAN, BASIC, or C compiler is required to build the
           modules written in those languages.
--------------------------------------------------------------------------
Directory: SAMPLES\PWBTUTOR

Contents:  Demonstrates the Programmer's Workbench environment.  This
           sample is intended to be used with the PWB tutorial in the
           Environment and Tools manual.
--------------------------------------------------------------------------
Directory: SAMPLES\SHOW

Contents:  A speedy text file browser, written entirely in assembly.
--------------------------------------------------------------------------
Directory: SAMPLES\TSR

Contents:  Demonstrates how to write a Terminate and Stay Resident utility
           (TSR) in assembly or in mixed C and assembly.  Includes a
           toolkit of TSR functions which can be used to write your own 
           TSR's.

Tools:     Requires Microsoft C to build the mixed-language example.

Notes:     When assembled with the /Zi switch, several modules will cause
           a warning related to line number information in a segment of
           class other than 'CODE'.  This is because the code in question
           is discarded after installation of the TSR, and cannot be
           debugged using CodeView.
--------------------------------------------------------------------------
Directory: SAMPLES\WINCLOCK

Contents:  A digital alarm clock for Microsoft Windows.  The left mouse
           button moves or resizes the clock; the right button brings up
           a menu.

Tools:     Requires the Microsoft Windows SDK.
--------------------------------------------------------------------------
Directory: SAMPLES\WINDLL

Contents:  Demonstrates writing a DLL for Microsoft Windows in assembly
           language.  Includes a Windows test program which calls the DLL; 
           the DLL can also be called from applications such as Microsoft
           Visual BASIC.

Tools:     Requires the Microsoft Windows SDK to build the test program.
--------------------------------------------------------------------------