mclGetDataLine

mclGetDataLine

void mclGetDataLine(UINT pIndex,
LPCTSTR pLine,
UINT pLineLength);

Parameters

pIndex

The write buffer line index. The number of EEPROM data lines in the write buffer can be obtained with a call to mclGetDataLineCount. The write buffer EEPROM data values range from 0 to mclGetDataLineCount - 1.

pLine

Points to a character buffer that receives the EEPROM data line. Refer to the remarks section for format details.

pLineLength

The length of the character buffer. It is recommended that the character buffer does not use a value of less than 60. For example,

char line[60]

Return Value

None

Remarks

Use a call to mclGetDataLine to read a single line of EEPROM data contained in the loader write buffer. The number of EEPROM data lines in the write buffer can be obtained with a call to mclGetDataLineCount. The write buffer EEPROM data values range from 0 to mclGetDataLineCount - 1. The line returned has the format

$0000 - $00 $01 $02 $03 $04 $05 $06 $07

where the first hexadecimal value indicates the starting address of EEPROM. The remainder of the line contains multiple EEPROM byte values. The write buffer can be initialised with a call to either mclLoadHexFile or mclRead. The write buffer may also be initialised with a call to mclAddHexLine and cleared with a call to mclClear