Click above to get retro games delivered to your door ever month!

_diInitDevice()
Initialize or remove access to device(s) or examine current device status
------------------------------------------------------------------------------
Syntax

    _diInitDevice([<nDevice>]) --> nInitDevices

Arguments

    <nDevice> is single device to be enabled/disabled.  An argument
    of 0 deinitializes all devices except the terminal screen.  A
    positive device handle initializes a single device.  A negative
    device handle deinitializes a single device.  Valid arguments are of
    the form +/-(2), or 0.

Returns

    nInitDevices is the sum of all initialized devices.  If the
    argument is empty, the return value is simply the prior value of the
    STATIC variable nInitDevices.  If an invalid argument is used, 0 is
    returned.  Otherwise, the return value is the adjusted sum of the
    initialized devices.

Description

    An internal function for the management of access to devices.
    Generally, this function only needs to be used via the  User
    Functions.  In di_Library version 0.1, it might be necessary to call
    _diInitDevice(0) if there are no additional device handles
    available.  Better garbage-collection User Functions will be
    included in later version.

Examples

    ? _diInitDevices()                  // Result:  1
    ? di_initHTML()                     // Result:  2
    ? di_initHTML()                     // Result:  4
    ? _diInitDevices()                  // Result:  7
    ? _diActiveDevice(4)                // Result: .T.
    ? _diInitDevices(0)                 // Result:  1
    ? _diActiveDevice(4)                // Result: .F.