Ioctl_Hal_Itc_Write_Sysparm - Intermec 700 Series User Manual

SECTION 7

IOCTL_HAL_ITC_WRITE_SYSPARM

Describes and enables the registry save location.
Usage:
Syntax:
Parameters:
Return Values:
ID Field Values:
#include "oemioctl.h"
BOOL KernelIoControl( IOCTL_HAL_ITC_WRITE_SYSPARM,
LPVOID lpInBuf,
DWORD nInBufSize,
LPVOID lpOutBuf,
DWORD nOutBufSize,
LPDWORD lpBytesReturned );
lpInBuf A single byte that may be one of the id values.
See "ID Field Values" below.
nInBufSize Must be set to the size of the lpInBuf in bytes.
lpOutBuf Must point to a buffer large enough to hold the data to be
written to the non-volatile data store.
nOutBufSize The size of lpOutBuf in bytes.
lpBytesReturned The number of bytes returned by the function.
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_BUFFER
may be returned when this function is used to get the error.
The id field of lpInBuf may be one of the following values:
ITC_REGISTRY_LOCATION
This IOCTL sets the default location for where to write the registry
when RegFlushKey() is called by an application. The registry may be
saved to Flash, a CompactFlash storage card or a SecureDigital storage
card. lpOutBuf must point to a buffer that contains a byte value of "1"
for the CompactFlash card or "2" for the SecureDigital card to specify the
location.
ITC_REGISTRY_SAVE_ENABLE
This function enables or disables the save registry to non-volatile media
feature of the RegFlushKey() function. lpOutBuf must be set to zero
(FALSE) if the feature is to be disabled or one (TRUE) if the feature is to
be enabled.
ITC_ DOCK_SWITCH
This IOCTL sets a position of the dock switch. The dock switch may be
set to either "modem" or "serial" positions. lpOutBuf must point to a
buffer that contains a byte value of either DOCK_MODEM or
DOCK_SERIAL as defined in OEMIOCTL.H; the value specifies the
position the switch is to be set.
700 Series Color Mobile Computer User's Manual
Programming
7-25