DOCUMENT:Q76504  06-MAY-2001  [masm]
TITLE   :Static Variables Declared in MASM Routines Called from C
PRODUCT :Microsoft Macro Assembler
PROD/VER:MS-DOS:5.0,5.10,6.0,6.0a,6.0b
OPER/SYS:
KEYWORDS:

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Macro Assembler (MASM), versions 5.0, 5.10, 6.0, 6.0a, 6.0b 
-------------------------------------------------------------------------------

SUMMARY
=======

The programs below demonstrate how a variable declared in a Microsoft Macro
Assembler (MASM) subprogram will keep its value between calls from a C main
program.

MORE INFORMATION
================

Link the two programs below with the following command:

   link cmain masmsub,,, /nod llibce;

Sample Code #1
--------------

   // Filename: CMAIN.C
   // Compile options needed: /c /AL

   #include <stdio.h>

   extern int far MasmSub () ;

   main ()
   {
      int i ;
      for (i = 1; i < 11; ++i)          // Call the MASM subprogram 10
      {                                 // times, and its return value
         printf ("%d\n", MasmSub()) ;   // will be incremented by 1 each
      }                                 // time.
   }

Sample Code #2
--------------

   ; Filename: MASMSUB.ASM
   ; Assemble options needed: /mx /ml

   .MODEL LARGE, C
   .DATA
      var DW 0        ; This variable will keeps its value between calls.
   .CODE
   PUBLIC MasmSub
   MasmSub PROC FAR
      INC var
      MOV AX, var     ; Since the function returns an int, C will get the
      RET             ; return value from AX.
   MasmSub ENDP
           END

Additional query words: kbinf 5.00 5.10 6.00

======================================================================
Keywords          :  
Technology        : kbMASMsearch kbAudDeveloper kbMASM600 kbMASM500 kbMASM600a kbMASM600b
Version           : MS-DOS:5.0,5.10,6.0,6.0a,6.0b

=============================================================================

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.

Copyright Microsoft Corporation 2001.