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;
}
Содержание OMNii HDK XT10
Страница 4: ......
Страница 10: ......
Страница 12: ......
Страница 18: ......
Страница 20: ......
Страница 24: ......
Страница 26: ......
Страница 32: ......
Страница 72: ......
Страница 90: ......
Страница 92: ......
Страница 116: ......
Страница 124: ......
Страница 126: ......
Страница 130: ......
Страница 132: ......
Страница 154: ......
Страница 168: ......
Страница 170: ......
Страница 182: ......
Страница 184: ......
Страница 188: ......