Chapter 4: Software
Omnii HDK API Functions
52
Psion Teklogix Omnii HDK User Manual
4.7.4.18 Hdk7545_ReadEepromHeader
Syntax
DWORD Hdk7545_ReadEepromHeader( HANDLE hdk, Hdk7545_Eeprom *eeprom );
Parameters
•
hdk – [in] an open HDK handle.
•
eeprom – [out] pointer to an instance of Hdk7545_Eeprom.
Description
Reads the contents of an EEPROM into the structure supplied by the caller. This function can only
read from the EEPROM on the connector specified in the call to Hdk7545_Open().
The caller must set the correct version [HDK7545_EEPROM_VERSION] and the correct size
[sizeof(Hdk7545_Eeprom)] in the supplied Hdk7545_Eeprom structure. If the values supplied are
not correct, an error is returned.
The format of the EEPROM is described in Chapter 8: “EEPROM Specifications”. It is the
responsibility of anyone developing expansion hardware to correctly program the EEPROMs. If
an EEPROM is not programmed properly, the values reported by the
Hdk7545_ReadEepromHeader function may be invalid.
Returns
•
ERROR_SUCCESS – if successful.
•
ERROR_INVALID_HANDLE – the specified handle is invalid.
•
ERROR_INVALID_PARAMETER – one of the parameters is incorrect/invalid.
•
ERROR_INVALID_DATA - an exception was generated.
•
ERROR_REVISION_MISMATCH – the EEPROM structure size/format/version supplied by
the caller does not match what was expected by the HDK and/or the hand-held device.
•
Other errors are possible.
ok = InterruptInitialize(sysIntr, hEvent, 0, 0) ;
if( !ok ) {
KernelIoControl(IOCTL_HAL_RELEASE_SYSINTR, &sysIntr,
sizeof(sysIntr), 0, 0, 0);
Hdk7545_Close(&hdkHandle);
return ERROR_NO_SYSTEM_RESOURCES;
}
// ...
InterruptDisable(sysIntr);
KernelIoControl(IOCTL_HAL_RELEASE_SYSINTR, &sysIntr,
sizeof(sysIntr), 0, 0, 0);
Hdk7545_Close(&hdkHandle);
return ERROR_SUCCESS;
}
Summary of Contents for OMNii HDK XT10
Page 4: ......
Page 10: ......
Page 12: ......
Page 18: ......
Page 20: ......
Page 24: ......
Page 26: ......
Page 32: ......
Page 72: ......
Page 90: ......
Page 92: ......
Page 116: ......
Page 124: ......
Page 126: ......
Page 130: ......
Page 132: ......
Page 154: ......
Page 168: ......
Page 170: ......
Page 182: ......
Page 184: ......
Page 188: ......