Chapter 3 — Configuring the Computer

Return Values

Returns TRUE if function succeeds. Returns FALSE if the function fails.

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

IOCTL_HAL_GET_BOOTLOADER_VERINFO

Returns the HAL version information of the OS image.

Usage

#include “oemioctl.h”

Syntax

BOOL KernelIoControl( IOCTL_HAL_GET_OAL_VERINFO,LPVOID lpInBuf, DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned );

Parameters

lpInBuf

Should be set to NULL.

 

 

 

 

nInBufSize

Should be set to zero.

 

lpOutBuf

Must point to a VERSIONINFO structure as defined by

 

OEMIOCTL.H. The fields should have these values:

 

cboemverinfo

Sizeof (tagOemVerInfo);

 

verinfover

1

 

sig;

“ITC\0”

 

id;

‘B’

 

tgtcustomer

“”

 

tgtplat

SeaRay

 

tgtplatversion Current build version # of bootstrap loader

 

tgtcputype[8]; “Intel\0”;

 

tgtcpu

“PXA255\0”

 

tgtcoreversion “”

 

 

date

Build time

 

time

Build date

nOutBufSize

The size of VERSIONINFO in bytes.

lpBytesReturned

The number of bytes returned to lpOutBuf.

 

 

 

 

Return Values

Returns TRUE if function succeeds. Returns FALSE if the function fails.

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

IOCTL_HAL_WARMBOOT

Causes the system to perform a warm-boot. The object store is retained.

Usage

#include “oemioctl.h”

Syntax

BOOL KernelIoControl( IOCTL_HAL_WARMBOOT,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned );

751G Color Mobile Computer User’s Manual

73

Page 87
Image 87
Intermec 751G user manual Ioctlhalgetbootloaderverinfo, Returns the HAL version information of the OS image