Programming—Chapter 7
251700Series Color Mobile Computer User’sManual
IOCTL_HAL_ITC_READ_PARM
Usage
#include “oemioctl.h”
Syntax
BOOL KernelIoControl( IOCTL_HAL_ITC_READ_PARM,LPVOID
lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD
nOutBufSize,LPDWORD lpBytesReturned );
Parameters
lpInBuf Points to this structure. See “ID Field Values”below.
struct PARMS {
BYTE id;
BYTE ClassId;
};
nInBufSize Must beset to the size of the PARMS structure.
lpOutBuf Must point to a buffer large enough to holdthe return data of the
function.If this field is set to NULL and nOutBufSize is set to zero
when the function is called the function willre turn the number
bytes required by the buffer.
nOutBufSize ThesizeoflpOutBufin bytes.
lpBytesReturned Numberof bytes returned by the function for the data requested.
ReturnValues
Returns TRUE if function succeeds. Returns FALSE if the function fails.

GetLastError()may be used to get the error value. Either

ERROR_INVALID_PARAMETER or

ERROR_INSUFFICIENT_BUFFERmay be returned when this fu nction

is used to get the error.

IDField Values

The id field of the PARMS structure may be one of the following values:

IDField Values
ITC_NVPARM_ETHERNET_ID
This IOCTL returns the Ethernet 802.11b or 802.11b/g MAC Address. Six bytes are returned in the buffer pointed
to by the lpOutBuffer parameter.
ITC_NVPARM_SERIAL_NUM
This IOCTLreturns the serial number of the device in BCD format.Six bytes are returned in the buffer pointedto
by the lpOutBuffer parameter.
ITC_NVPARM_MANF_DATE
This IOCTL returns the device date of manufacture in the BCD YYYY/MM/DD format. Four bytes are returned in
the buffer pointed to by the lpOutBuffer parameter.
ITC_NVPARM_SERVICE_DATE
This IOCTL returns the device’s date of last service in BCD YYYY/MM/DD format. Four bytes are returned in the
buffer pointed to by the lpOutBuffer parameter.