Microsoft KB Archive/59884

{|
 * width="100%"|

Determining If Your TSR Has Already Been Installed

 * }

Q59884

5.10 6.00 6.00a 6.00ax 7.00 | 1.00 1.50 MS-DOS | WINDOWS kbprg -- The information in this article applies to: - Microsoft C for MS-DOS, versions 5.1, 6.0, 6.0a, and 6.0ax - Microsoft C/C++ for MS-DOS, version 7.0 - Microsoft Visual C++ for Windows, versions 1.0 and 1.5 -- SUMMARY ======= In Microsoft C, when writing a TSR (terminate-and-stay-resident) program, it is possible to utilize the multiplex interrupt (2fh) to determine whether your TSR has already been loaded into memory. Set up an interrupt service routine (ISR) for this interrupt that will compare the AH register with a predefined TSR number (ID#) and change the AL register to a nonzero value if the two are equal. MORE INFORMATION ================ When using the interrupt keyword in Microsoft C, registers are pushed onto the stack before each function call. To access these register values from within an ISR, define the ISR function as accepting these registers as parameters. Once this is set up, the installation part of the TSR can make a call to the multiplex interrupt with the AH register set to the ID# of the TSR, and the AL register set to 00h. If the handler is currently installed, it will pick up these values in the AX register and then change the AL register to 01h and return this &quot;installed&quot; signal to the calling program. If the ID# in the AL register is not that of the TSR, the TSR can simply chain the interrupt back to its original vector. In summary, to have your TSR check to see if it is already installed, do the following: 1. Make an int86 call with the following: inregs.h.ah=id#(0xc0-0xff) inregs.h.al=0x00 2. If outregs.h.al != 0x00, program is in memory, don't re-install. 3. Else, revector INT2fh to your own ISR. This ISR should do the following: a. Take as parameters the registers pushed on the stack by the interrupt keyword (see REGPAK below). b. Check the AH register, hibyte of the AX register, with a TSR ID#(0xc0-0xff). c. If AH=TSR ID#, change al to 0x01. d. Else, chain to the old INT2fh vector. 4. Terminate and stay resident. The following is a simple example of an ISR that will accomplish step 3 (above) nicely with a TSR ID# of 0xc9. For more information about the multiplex interrupt and its function, please refer to &quot;The New Peter Norton Programmer's Guide to The IBM PC & PS/2,&quot; page 303-306. For an example of a TSR, see the application note &quot;TSR Example Dirzap.C,&quot; which is available from Microsoft Product Support Services. Sample Code --- #include void (interrupt far *original_int2fh); /*set to original*/ /* int2fh handler*/ #define HIBYTE(x) (((unsigned) (x) >> 8) & 0xff) #define REGPAK unsigned es, unsigned ds, unsigned di, \ unsigned si, unsigned bp, unsigned sp, \ unsigned bx, unsigned dx, unsigned cx, \ unsigned ax, unsigned ip, unsigned cs, \ unsigned flags void interrupt far new_int2fh(REGPAK) { if (HIBYTE(ax)==0xc9) /* check TSR ID# */ ax=0xc901; /* set AL to 01 */ else _chain_intr(original_int2fh); } NOTE: The keyword 'interrupt' is '__interupt' in versions 7.0 and 8.0 of the Microsoft C/C++ compiler. Additional reference words: kbinf 5.10 6.00 6.00a 6.00ax 7.00 1.00 1.50 KBCategory: kbprg KBSubcategory: PrgTSR

Keywords : kb16bitonly

Issue type :

Technology : kbVCsearch kbAudDeveloper kbPTProdChange kbvc150 kbvc100 kbCCompSearch kbZNotKeyword3 kbCComp510DOS kbCComp600DOS kbCComp600aDOS kbCComp600axDOS kbCVC700DOS