SECTION 3
Supporting Windows Applications
3-8 PEN*KEY
R
6200/6300 Hand-Held Computer Programmer’s Reference Guide
Shutting Down Windows
Windows shuts down automatically when the shell program exits. However,
because NORSHELL does not exit, it shuts Windows down when it detects that
the application from the
NorShellRun
line no longer exists. An application may
shut down Windows on its own by calling the Windows 3.1
ExitWindows
function. This is the preferred method.
Windows Power Management Driver
The NORAPM.DLL driver provides a Windows interface to the APM BIOS
extensions. The driver's functions include the following:
"
Idling the CPU when Windows has nothing to do.
"
TimingĆout the backlight and suspending the computer after periods of user
inactivity.
"
Warning the user about critical power management events, such as low
batteries, unless an application wants to take over that responsibility.
"
Broadcasting APM event codes to Windows applications and drivers and
DOS TSRs.
"
Providing a Windows API for APM functions, such as setting and getting
the power state of system components.
The NORAPM.DLL version number is logged into the
NORAPM.DLL=
entry in
the [
boot.description
] area of the SYSTEM.INI file each time Windows is started.
Installation and Configuration
NORAPM.DLL is a Windows 3.1 installable driver. The APM 1.1 BIOS
extensions are required to be installed before Windows is started. The APM
BIOS (that NORAPM needs) may come from the builtĆin system BIOS or from a
separate DOS TSR, NORAPM.EXE, which must be run before Windows is
started. To install NORAPM.DLL:
Place a keyword (e.g.,
power
) on the
drivers=
" line, and add a line to the
[
drivers
]" section of SYSTEM.INI, equating that keyword with the actual
path to the power management driver. However, if this path is included in
the DOS path, then use the name of the power management driver,
NORAPM.DLL. Also, the power management keyword should be first on
the
drivers=
" line.
The following is an example of a section of the SYSTEM.INI file, showing a
typical installation.
[boot]
drivers= power pen penwindows scanner npcp irda
[drivers]
power=norapm.dll
pen=norpen.dll
drivers
=
Tells Windows to load the installable drivers. This list of drivers is the
standard set (and organized in the exact order shown in the example above).
The significant drivers here, are
power
and
pen.
These are token names for the
drivers. The actual driver names are defined in the
[drivers]
section of the
SYSTEM.INI file (e.g.,
power=
,
pen=
, etc.).
power
=
Tells Windows the actual name of the installable Power Management
driver named in the
[boot]
section of the SYSTEM.INI file (listed above).
3. Windows
Applications
