IEC_BACNET_FILEACCESS_INFO (STRUCT)

TYPE IEC_BACNET_FILEACCESS_INFO : STRUCT

This structure contains information for file object data transfers.

InOut:

Name

Type

Comment

deviceInstance

IEC_BACNET_INST_NUMBER

The device instance number that contains the file object to access.

fileObject

IEC_BACNET_OBJECT_ID

The object identifier of the file object to access.

fixedRecordSize

IEC_BACNET_VALUE_SIZE

The fixed record size used to write if no record marks are used (bUseAndWriteRecordmarksAndSize is FALSE) in the data for the record access type file.

bResetFileSizeOnWrite

IEC_BACNET_BOOLEAN

If set the file size property or recotrd count property from the fileobject will be written to 0 before the file data is transfered. This might be required to erase the previous data in the file object before the new data may be written.

bUseAndWriteRecordmarksAndSize

IEC_BACNET_BOOLEAN

If set record marks are expected in the file data to write or will be written in the file on read. The first 4 bytes of each record contain a preamble in following format: 0xA55AA55A in litte endian order. The next 4 bytes contain the actual length (N) of the record in little endian order and the following N bytes will contain the record data. If not set the record file read will be stored without any record information in biunary format. To write a record file the fixed record size will be used.

bUseAndWriteRecordsInAsciiHexFormat

IEC_BACNET_BOOLEAN

If set record file objects read are stored as ASCII hex strings in the file terminated by ‘n’ (0x0A) for each record. Record file objects to write are expected in this format and will generate errors if the format is wrong. If this option is set the bUseAndWriteRecordmarksAndSize option can’t be used.

pszPathToFileData

POINTER TO IEC_BACNET_BYTE

The path to the file for the file object to write the containing data into it or to store the read file objrct data.