gmh5225 / wininc Goto Github PK

 A. About WinInc

   WinInc is a set of assembly include files in Masm-syntax intended to
   simplify writing assembly code for Windows ( 32- and 64-bit ). It can
   be used for applications and dlls written entirely in assembly and
   also for the assembly portions of mixed-language projects.

   WinInc also includes module definition files to create Win32 and
   Win64 import libraries. Usage is optional, one may as well use the
   libraries supplied by the MS Platform SDK.

   Some samples in the SAMPLES directory illustrate how to use WinInc.


 B. Requirements

   a) Win32

   Assemblers which are able to digest the WinInc include files are
   Masm, JWasm, Uasm and AsmC.

   b) Win64

   For Win64 development, the set of tools is smaller, because
   MS Masm64 won't work - it has severe limitations.


 C. Installation

   When creating binaries for Windows the link step will require import
   libraries to resolve the references to the Windows API. One may just use
   the libraries included in the MS PSDK, then the following steps can be
   skipped.

   a) Create Standard Windows Import Libs

   The standard Windows libraries are so-called import libraries. Import
   libraries contain just references to the dlls where the functions are
   to be found. Several tools can create those libraries from simple text files.
   What's used here are 2 programs:
   
    - def2jwt: the source is in Tools; It's supposed to be assembled with
      jwasm, using Tools\def2jwt.bat.
    - JWLib: the binary is part of the jwlink package.

   After both programs are available, the import libraries may be generated:

   For Win32, run MAKELIBS.BAT in directory DEF.
   For Win64, run MAKELIBS.BAT in directory DEF64.

   b) Create UUID.LIB

   Regretably not all Windows libraries are just import libraries which can 
   be created by MS LIB. Some contain static code. One of those - which is
   crucial for COM - is UUID.LIB. The file UUID.LIB contained in Lib subdir
   is not a fully functional version of this lib. It is created by tool
   UUID\mkguids.exe and contains just the very minimum of GUIDs. If you need
   additional GUIDs in your binary, either get a version of UUID.LIB from
   other sources (PSDK for example) or add the missing GUIDS to file
   UUID\uuid and rerun UUID\makeuuid.bat.


 D. License

  All files contained in WinInc are Public Domain. The 'copyright'
  string in the include files refers to tool h2incx, not to the 
  include files themselves.

  Japheth