SECTION 3
Supporting Windows Applications
PEN*KEY
R
6200/6300 Hand-Held Computer Programmer’s Reference Guide 3-17
CRITICALSUSPEND, Critical System Suspend Notification
This event is never broadcast. NORAPM.DLL immediately suspends the system
when it receives it and broadcasts a CRITICALRESUME event upon resuming.
CRITICALRESUME, Critical Resume System Notification
The system is suspended without sending a notification broadcast in advance.
This event is usually caused by a power failure. Drivers should typically disable
and reenable themselves when receiving this message.
STANDBYREQUEST, System Standby Request Notification
Because of the efficacy of the suspend mode, NORAND systems do not currently
implement a
standby
mode. In addition to STANDBYREQUEST, the
USERSTANDBY and USERSTANDBYRESUME messages are also ignored or
are never generated.
APM OEM Event Codes
Norand Mobile Systems Division continues to refine its use of the APM OEM
event codes listed in APMCODES.H. See
Appendix B, Common PEN*KEY 6000
Series Information
. If you want to process a specific event, contact Customer
Support Center at 800Ć755Ć5505 (U.S.A. or Canada) or 425Ć356Ć1799 and inquire
whether that event is available on your particular system.
Generally, you should attempt to use APM 1.1 standardized event codes
whenever appropriate; however, we may choose to make additional events
available on systems with extended functionality. The Norand OEM codes listed
in APMCODES.H represent currently defined codes but do not imply that all or
any OEM events are available on any particular system.
Power Management Programming Interface
NORAPM.DLL exports an API to make power management functions available
to applications and drivers. Two APIs are supported:
"
A protectĆmode Windows DLLĆstyle interface for Windows applications and
drivers and, eventually,
"
A realĆmode software interrupt API for DOS drivers running in real mode.
Windows Protect-Mode API
The following paragraphs describe the intended usage for each function and
structure in NORAPM.H. Please see the header file listing, in
Appendix B,
Common PEN*KEY 6000 Series Information
, for the actual parameter and
return code definitions.
To access the functions exported by NORAPM.DLL, include the NORAPM.H and
APMCODES.H in your program and link to the functions you want to use at
runtime by using the Windows
L
oadLibrary
and
G
etProcAddress
functions.
Note that each function prototype in NORAPM.H comes with a companion
typedef
that you can use to create a pointer variable to the function.
3. Windows
Applications
