User's Manual

ProgrammingChapter 7
301700 Series Color Mobile Computer User’s Manual
Notifications
Use the following information to programmatically control the vibrator, to
write an application to turn on the vibrator when a message is received via
the WLAN radio link, and turn it off when the user hits a key.
Vibrator support is implemented in the NLED driver as a false LED. The
vibrator is LED 5 and is identified with an CycleAdjust of –1. The vibrate
option is only available in the notifications panel when the vibrator is pres-
ent in the system.
Regarding an applications interface to NLED.DLL, LEDs must be avail-
able for use by applications. This is possible via two functions exported by
the COREDLL.DLL f ile. To use the LED functions, declare these as ex-
tern ”C as follows:
extern ”C” BOOL WINAPI NLEDGetDeviceInfo(UINT nInfoId,
void *pOutput);
extern ”C” BOOL WINAPI NLEDSetDevice( UINT nDeviceId, void
*pInput);
The LEDs are enumerated for access through the data structures associated
with these APIs:
S Notification LED 0
S Radio On LED 1 (does not apply to the 730 Computer)
S Alpha Lock LED 2
S Scanner LED 3
S Low Battery 4
S Vibrator 5 (does not apply to the 730 Computer)