Chapter 3 — Configuring the Computer

IOCTL_HAL_COLDBOOT

Forces a cold reboot. This resets the 751G, reloads Windows CE as if a power-up was performed, and discards the contents of the Windows CE RAM-based object store (page 74).

IOCTL_HAL_WARMBOOT

Performs a system warm-boot, preserving the object store (page 73).

Note: Using IOCTL_HAL_REBOOT is no longer recommended, use either IOCTL_HAL_WARMBOOT or IOCTL_HAL_COLDBOOT. IOCTL_HAL_REBOOT is still supported for backward-compatibility but its use can lead to difficulties.

Reprogramming the 751G Keypad

Note: Use caution when remapping the keypad. Improper remapping may render the keypad unusable. Data within the 751G could also be lost, should any problems occur.

Applications have the ability to remap keys on the 751G keypad. This allows applications to enable keys that would otherwise not be available, such as the [F1] function key. Also, to disable keys that should not be available, such as the alpha key because no alpha entry is required. Use care when attempting to remap the keypad because improper remapping may render the keypad unusable. Cold-booting the device loads the default keymap, thus correcting this situation.

Note that remapping the keys in this way affects the key mapping for the entire system, not just for the application that does the remapping.

There are three “planes” supported for the 751G keypad. Keys used in more than one shift plane must be described in each plane.

The unshifted plane contains values from the keypad when not pressed with other keys, such as pressing [1] to enter a “1.”

The orange plane contains values from the keypad when a key is simultaneously pressed with the [orange] key, such as pressing [orange] [1] to enter a “Send” command.

The alpha plane contains values from the keypad when the keypad is placed in alpha mode by pressing the green [Alpha] key, such as pressing [Alpha] [1] to enter a “Caps” command.

Key Values

Key values for each plane are stored in the registry. All units ship with a default key mapping already loaded in the registry. Applications that wish to change the default mapping need to read the appropriate key from the registry into an array of Words, modify the values required and then write the updated values back into the registry. The registry access can be done with standard Microsoft API calls, such as RegOpenKeyEx(), RegQueryValueEx(), and RegSetValueEx().

751G Color Mobile Computer User’s Manual

99

Page 113
Image 113
Intermec user manual Reprogramming the 751G Keypad, Key Values, Performs a system warm-boot, preserving the object store