beautypg.com

Be_readbezeleeprom, Syntax, Remarks – Rockwell Automation 6182 SDK User Manual

Page 50: Return value, Portability

background image

4–10

RAC6182-Specific Extensions to the CE API

Publication 6182-UM002B-EN-P

be_ReadBezelEEPROM

This function reads bezel EEPROM. It is prototyped in bezeleeprom.h.

Syntax

#include
#include

DWORD be_ReadBezelEEPROM(DWORD dwAdress, DWORD dwLength, UCHAR

*pucData)

Remarks
Reads dwLength bytes starting at offset dwAddress in the EEPROM into
a caller allocated buffer beginning at pucData. All reads are implicitly
mutexed.

When CRC mode is enabled, EEPROM contents are accessible for
reading beginning at offset 0x02. When the CRC is currently invalid,
any read will still return the raw data at the requested locations, but will
return BEZEL_EEPROM_INVALID_CRC error.

When CRC mode is disabled the entire bezel EEPROM is accessible for
reading. Reading any location will never result in the return of a
BEZEL_EEPROM_INVALID_CRC error, regardless of the validity of
the CRC value.

Return Value
The possible return values are represented by the following macros,
defined in bezeleeprom.h:

Macro

Description

BEZEL_EEPROM_OK

EEPROM present, arguments valid, function
completed successfully.

BEZEL_EEPROM_
DEVICE_NOT_
PRESENT

No EEPROM detected – either bezel not present or
EEPROM on it not functioning.

BEZEL_EEPROM_
INVALID_
PARAMETER

Bad parameter passed to function, for example a
NULL pointer or an address out of range.

BEZEL_EEPROM_
INVALID_CRC

CRC mode is enabled and the CRC on the
EEPROM is currently invalid.

Portability
This function is specific to the RAC6182 hardware.

This manual is related to the following products: