Kernel i/o controls, Ioctl_hal_get_device_info, Syntax – Intermec 751G User Manual

Page 81: Parameters return values

Advertising
background image

Chapter 3 — Configuring the Computer

751G Color Mobile Computer User’s Manual

67

Should you want your 751G to display a full screen, use the following links.
These give full instructions on how to display full screen.

• Instructions on how to create a full screen application for eVC++

applications using an SHFullScreen() API:

support.microsoft.com/support/kb/articles/Q266/2/44.ASP

• Instructions on how to create a full screen application for eVB

applications also using the SHFullScreen() API:

support.microsoft.com/support/kb/articles/Q265/4/51.ASP

Kernel I/O Controls

This describes the KernelIoControl() functions available to application
programmers. Most C++ applications will need to prototype the function
as the following to avoid link and compile errors.

extern “C” BOOL KernelIoControl(DWORD dwIoControlCode, LPVOID lpInBuf, DWORD
nInBufSize, LPVOID lpOutBuf, DWORD nOutBufSize, LPDWORD lpBytesReturned);

You can also see the Device Resource Kit in the Intermec Developer
Library (IDL) for information about these functions. The IDL is available
as a download from the Intermec web site at

www.intermec.com/idl

.

Contact your Intermec representative for more information.

IOCTL_HAL_GET_DEVICE_INFO

This IOCTL returns either the platform type or the OEMPLATFORM
name based on an input value.

Syntax

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

Parameters

Return Values

Returns TRUE if function succeeds. Returns FALSE if the function fails.
GetLastError() may be used to get the extended error value.

lpInBuf

Points to a DWORD containing either the
SPI_GETPLATFORMTYPE or SPI_GETOEMINFO value.

lpInBufSize

Must be 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 “PocketPC\0” Unicode string is returned. If
SPI_GETOEMINFO is specified in lpInBuf, then the “Intermec
700\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.

Advertising