Operation Manual

Programming—Chapter 7
215700 Series Color Mobile Computer User’s Manual
ID Field Values (continued)
ITC_ WAKEUP_MASK
This IOCTL sets a bit mask that represents the mask for the five programmable wakeup keys. The I/O key is not a
programmable wakeup key. By default it is always the s ystem resume key and all other keys are set to disable key
wakeup. A zero in a bit position masks the wakeup for that key. A one in a bit position enables wakeup for that key.
lpOutBuf mu st point to a bu ffer that contains a byte value of a wakeu p mask consis ting of the OR’ed constants as
definedinOEMIOCTL.H.Onlythefollowingkeysareprogrammableaswakeupevents.
#define SCANNER_TRIGGER 1
#define SCANNER_LEFT 2
#define SCANNER_RIGHT 4
#define GOLD_A1 8
#define GOLD_A2 0x10
ITC_AMBIENT_KEYBOARD (does not apply to the 730 Computer)
This IOCTL sets the threshold for the keypad ambient sensor. This can be a value from 0 (always off) to 255 (always
on). lpOutBuf must point to a buffer that c ontains a byte value of th e desired setting.
ITC_AMBIENT_FRONTLIGHT (does not apply to the 730 Computer)
This IOCTL sets the threshold for the frontlight ambient s ensor. This can be a value from 0 (always off) to 255.
lpOutBuf mu st point to a bu ffer that contains a byte value of the desired setting.
IOCTL_HAL_GET_DEVICEID
This returns the device ID. There are two types of device IDs supported,
which are differentiated based on the size of the output buffer. The UUID
is returned if the buffer size is set to sizeof(UNIQUE_DEVICEID),other-
wisetheoldstyledeviceIDisreturned.
Usage
#include “pkfuncs.h”
#include “deviceid.h”
Syntax
BOOL KernelIoControl( IOCTL_HAL_GET_DEVICEID,LPVOID lpInBuf,DWORD
nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned );
Parameters
lpInBuf Shou ld be set to NULL. STRICT_ID s ettings are not supported.
lpInBufSize Should be set to zero.
lpOutBuf Must point to a UNIQUE_DEVICEID structure as defined by
DEVICEID.H if the UUID is to be returned
nOutBufSize The size of the UNIQUE_DEVICEID in bytes if the UUID is to
be returned. A DEVICE_ID as defined by PKFUNCS.H is re -
turned if the size in bytes is greater than or equal to sizeof(DE-
VICE_ID).
lpBytesReturned The nu mber of bytes re turned by the function.
Return Values
Returns TRUE if function succeeds. Returns FALSE if the function fails.
GetLastError() may be used to get the extended error value.