Return to readme.txt CVS log

Up to [WindowsNT SDKs] / q_a / samples / ddk / portio

Annotation of q_a/samples/ddk/portio/readme.txt, revision 1.1.1.1

1.1       root        1: Generic Port I/O Driver
                      2: 
                      3: Included with this file:
                      4:      a Windows NT device driver to provide simple access to 8/16/32 bit IO
                      5:      ports using IOCTL calls.
                      6: 
                      7:      some simple test programs which read from ports and write to them. 
                      8: 
                      9: This sample is based on a driver submitted by Robert R. Howell, which in turn
                     10: was based on the adlib driver in the DDK.  We cleaned up the comments, tested
                     11: dynamic loading/unloading and added registry support.  Any questions regarding
                     12: this sample should be directed to Microsoft.
                     13: 
                     14: This driver provides an example of a minimal driver.  Neither it, nor the
                     15: sample programs are intended to be used in a production environment.  Rather,
                     16: they are intended as a skeleton driver for those devices which do not use
                     17: interrupts or DMA.
                     18: 
                     19: ===============================================================
                     20: BUILDING THE DRIVER AND EXAMPLES:
                     21: ---------------------------------------------------------------
                     22: To compile the device driver:
                     23:  
                     24:     1) Run the "SETENV.BAT" which should be in the MSTOOLS directory.  This 
                     25:        sets basic environment variables needed by NT.  The program does not 
                     26:        require any arguments. 
                     27: 
                     28:     2) Run the "SETENV.BAT" which should be in the DDK directory.  This sets 
                     29:        the environment variables needed by the DDK programs.  It does require 
                     30:        command line arguments.  It will print out instructions if run without
                     31:        arguments.
                     32: 
                     33:     3) Run "BUILD".  This invokes the Microsoft make routines.
                     34:        They produce log files called BUILD.WRN, and BUILD.LOG.
                     35:        The WRN file will contain warnings that no components have been
                     36:        extracted from certain libraries, even if the build succeeds.
                     37:        If it does succeed the driver will be named genport.sys and
                     38:        can be found in the I386 subdirectory created by BUILD.
                     39: 
                     40:     4) Copy the genport.sys file from the obj\I386 subdirectory created by
                     41:        BUILD to the \WINNT\SYSTEM32\DRIVERS directory where all the NT device
                     42:        drivers are stored.  If the system responds  "ACCESS DENIED" then a
                     43:        previous version of the file is currently in use, and NT will not let
                     44:        you replace it.  You can unload it by typing "net stop genport".
                     45: 
                     46: ---------------------------------------------------------------------------
                     47: To compile the NT test programs:
                     48: 
                     49:     2) Run "SETENV.BAT" which is in the MSTOOLS directory.  It sets the 
                     50:        environment variables needed by the SDK programs.
                     51: 
                     52:     3) Run "NMAKE -f gptest.mak".  It will build two programs:  gpdread and
                     53:        gpdwrite.  If you just type the program name without any parameters,
                     54:        they will print instructions.
                     55: 
                     56: ------------------------------------------------------------------------
                     57: To install the Generic Port I/O driver (GENPORT) use the REGINI utility to
                     58: create the entries listed in the genport.ini file.
                     59: 
                     60: --------------------------------------------------------
                     61: To use the IOCTL directly, see the comments in the example programs.
                     62: 
                     63: They
                     64:       1) Open "\\.\GpdDev" using CreateFile.
                     65:       2) Read from the port by placing the relative address (0, 1, 2, .. )
                     66:          into a buffer, calling an IOCTL, then reading a buffer.
                     67:       3) Write to the port by placing the relative address and a 
                     68:          value into a buffer then calling an IOCTL. 
                     69:       4) Close the device with  CloseHandle.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.