home *** CD-ROM | disk | FTP | other *** search
/ Microsoft Programmer's Library 1.3 / Microsoft-Programers-Library-v1.3.iso / sampcode / os2sdk / os2sdk12 / spy / readme < prev    next >
Encoding:
Text File  |  1989-11-20  |  2.3 KB  |  55 lines
  1. The spy program and dynamic link library, is a sample application that
  2. hooks the HK_INPUT and/or HK_SENDMSG hooks, and spys on what messages
  3. are sent to which window.  
  4.  
  5. The application currently has two threads:
  6.   1) The main thread controls the user interface.
  7.   2) The second thread waits for messages from the hooks.
  8.  
  9. This tool is very useful for debugging, and looks up symbols
  10. from symbol files with the "Spy...List Near Symbol..." selection.
  11. This is "context sensitive" -- given the appropriate PID, you can
  12. identify symbols given that context.  For example, you could run
  13. another application, look at the window for that application
  14. (using the Windows...Window List... option), get the window's PID,
  15. and perhaps print out where in the window procedure you are (by
  16. looking in the Pfnwp: field).
  17.  
  18. Note:  Since the "List Near Symbol" dialog box is modeless, you can move
  19. it off to the side while you work on something else (although its position
  20. is saved relative to the SPY main window).
  21.  
  22.  
  23. File List:
  24.   message.c    - Processes Message dialog box
  25.   options.c    - Processes Options style dialog boxes
  26.   queues.c    - Processes "Message Queue List" dialog
  27.   readme    - This file
  28.   spy        - Make file for the program and the DLL
  29.   spy.c        - The source to the executable program
  30.   spy.def    - Definition file for executable program
  31.   spy.h        - Headers
  32.   spy.ico    - The icon for the application
  33.   spy.rc    - The resource file
  34.   spydlgs.dlg    - Dialog definitions
  35.   spyhook    - Makefile for the SPYHOOK library
  36.   spyhook.c    - Source to the DLL
  37.   spyhook.def    - Definition file for the DLL
  38.   spyhook.h    - Header file for the DLL
  39.   spyhstrt.asm    - Startup code for the DLL
  40.   spytbls.c    - Output Message Tables for SPY program
  41.   spyutil.asm    - Assembly language utility routines
  42.   symbol.c    - Code for displaying symbols
  43.   symbol.h    - Headers needed to read .SYM symbol files
  44.   window.c    - Spy Window dialog processing
  45.  
  46.   spyhook.h    - include file gets copied to ..\include
  47.   spyhook.lib    - import library gets copied to ..\lib (and deleted)
  48.   spyhook.dll    - dynamic link library gets copied to ..\dll (and deleted)
  49.  
  50. Note:   This application needs "selector.h", which should be in ..\include.
  51.  
  52. Bugs:    Spy...List Near Symbol produces a dialog box with a size border.
  53.     However, the controls are not always redrawn as expected if you
  54.     change the size of the dialog box.
  55.