User's Manual

Chapter 7 — Programming
CN30 Mobile Computer User’s Manual 145
lpInBuf Points to a DWORD containing either the
SPI_GETPLATFORMTYPE or SPI_GETOEMINFO value.
lpInBufSize Must set to sizeof(DWORD).
lpOutBuf Must point to a buffer large enough to hold the return data of the
function. If SPI_GETPLATFORMTYPE is specified in lpInBuf,
then the “XScale\0” Unicode string is returned. If SPI_GETOEMINFO
is specified in lpInBuf, then the “Intermec 751\0” Unicode
string is returned.
nOutBufSize The size of lpOutBuf in bytes. Must be large enough to hold the
string returned.
lpBytesReturned The actual number of bytes returned by the function for the data
requested.
Return Values
Returns TRUE if function succeeds. Returns FALSE if the function fails.
May use GetLastError() to get the extended error value.
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 set to the size of the PARMS structure.
lpOutBuf Must point to a buffer large enough to hold the 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 returns the number bytes
required by the buffer.
nOutBufSize The size of lpOutBuf in bytes.
lpBytesReturned Number of bytes returned by the function for the data requested.
Return Values
Returns TRUE if the function succeeds. Returns FALSE if the function
fails. May use GetLastError() to get the error value. Either
ERROR_INVALID_PARAMETER or
ERROR_INSUFFICIENT_BUFFER may return when this function is
used to get the error.
ID Field Values
The id field of the PARMS structure may be one of the following values:
ID Field Values
ITC_NVPARM_SERIAL_NUM