IEC_BACNET_OBJECT_DATA_REQUEST (STRUCT)ΒΆ

TYPE IEC_BACNET_OBJECT_DATA_REQUEST : STRUCT

This structure contains all parameters for initiating an object properties retrieval for the specified device.

InOut:

Name

Type

Comment

instance

IEC_BACNET_INST_NUMBER

The device instance number for which the object information is requested.

This specifies the instance of the device. The valid range is from ::BACNET_INST_NUMBER_MIN to ::BACNET_INST_NUMBER_MAX.

nObjectIds

IEC_BACNET_ELEMENT_COUNT

The number of entries in the object identifier list.

This specifies the number of entries in the object identifier list for the objects to retrieve the requested property data. If this is 0 all objects in the specified device will be retrieved.

pObjectIds

POINTER TO IEC_BACNET_OBJECT_ID

The pointer to the entries for the object identifier list.

This specifies the pointer to the entries in the object identifier list for the objects to retrieve the requested property data. If this is NULL all objects in the specified device will be retrieved.

nMaxActions

IEC_BACNET_BYTE

The maximum number of concurrent requests initiated into the network.

This limits the number of concurrent requests initiated. The lowest permitted value is 1 and the upper range is limited to a value of 100.

bRetrieveOptional

IEC_BACNET_BOOLEAN

The flag specifying if optional properties are retrieved.

If set to TRUE any optional property data will also be read from the object. This option will only work for the standard object types and standard properties which are marked as optional and only if the object contains the property property-list or if the device supports the read-property- multiple service.

bRetrieveProprietary

IEC_BACNET_BOOLEAN

The flag specifying if optional properties are retrieved.

If set to TRUE any proprietary property data will also be read from the object. This option will only work if the object contains the property property-list or if the device supports the read-property- multiple service.