X-Hacker.org- FORCE Data Base Compiler - ##############################################################################

Click above to get retro games delivered to your door ever month! X-Hacker.org- FORCE Data Base Compiler - ##############################################################################

[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]

##############################################################################
###+---------------+##########################################################
#+-| TSR_INSTALL() |---------------------------------+########################
#| +---------------+ Installed a multiplex id number |########################
#+---------------------------------------------------+########################
##############################################################################
##############################################################################
#+--| Summary |-------------+#################################################
#|     #INCLUDE tsr.hdr     |#################################################
#+--------------------------+#################################################
##############################################################################
##############################################################################
#+--| Syntax |------------------------------------+###########################
#|     FUNCTION LOGICAL tsr_install PROTOTYPE     |###########################
#|      PARAMETERS VALUE UINT multiplex_id        |###########################
#+------------------------------------------------+###########################
##############################################################################
##############################################################################
######+---| Description |----------------------------------------------+######
######| The tsr_install() function installed a multiplex id number.    |######
######| This number is used to assign a unique number to a TSR program |######
######| so that                                                        |######
######|    * a. an owner can determine whether a particular TSR        |######
######|         program is installed.                                  |######
######|    * b. another process can determine whether ANY TSR          |######
######|         program is installed.                                  |######
######| -------------------------------------------------------------- |######
######| The multiplex id is managed by DOS, not by the FORCE runtime   |######
######| library.  Not all TSR programs install a multiplex id number.  |######
######| It is good programming practice to do so.                      |######
######+----------------------------------------------------------------+######
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########|                                                          |#########
#########| #define MY_ID 255                                        |#########
#########|                                                          |#########
#########| IF .NOT. tsr_installed( &MY_ID )                         |#########
#########|     ? "Already installed"                                |#########
#########| ENDIF                                                    |#########
#########|     ? "Installed ID", &MY_ID                             |#########
#########| ENDIF                                                    |#########
#########+----------------------------------------------------------+#########
##############################################################################

See Also: proc_entry() timer_entry() tsr unload_tsr

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson