BACnetReadAllPropertyDataContents
(FUN)
FUNCTION BACnetReadAllPropertyDataContents : IEC_BACNET_STATUS
Tries to read all property contained data at once.
Sends one or more requests to read the value of a property of an object. This function is a convenience function. It tries to get the complete property contained data in different ways automatically so that the user application has not to implement special strategies and fallbacks here.
- InOut:
Scope
Name
Type
Comment
Return
BACnetReadAllPropertyDataContents
Input
pSourceAddress
POINTER TO IEC_BACNET_ADDRESS
If the BACnet application has only one device constructed and installed, this can be 0. In this case the MAC address of this device will be used. Otherwise this shall be the MAC address returned on device object construction.
pDestinationAddress
POINTER TO IEC_BACNET_ADDRESS
This is the MAC address of the device to which the request should be sent.
pReadInfo
POINTER TO IEC_BACNET_READ_INFO
A pointer to the service information data structure. This data structure identifies the property within the device and includes the object ID, property ID, and array index.
pAPDUParams
POINTER TO IEC_BACNET_APDU_PROPERTIES
A pointer to the APDU-Properties structure which sets APDU properties for this transaction only. This does not change global defaults or settings for the application APDU Properties. This argument may be 0. In this case APDU properties are used which were specified in the device object properties of the applications device which sends the request.
pContents
POINTER TO IEC_BACNET_PROPERTY_CONTENTS
Pointer to a property contents buffer structure. This data structure must contain a pointer to a buffer into which the value is copied. Upon successful completion, the contents IEC_BACNET_DATA_TYPE tag attribute indicates the datatype of the property. The buffer pointer in the property contents structure may be 0 along with the size. In this case the API will fill the buffer and the application is responsible to release it with a call to BACnetFreeStackAllocatedMemory if the buffer is no longer needed.
pTransactionToken
POINTER TO BACnetAsyncTransactionToken
Transaction token of the asynchronous call - see BACnetAsyncTransactionToken.
pError
POINTER TO IEC_BACNET_ERROR
A pointer to a structure to hold BACnet Error information. pError may be 0 if the application isn’t interested in detailed error information.