BACnetRetrieveObjectData (FUN)ΒΆ

FUNCTION BACnetRetrieveObjectData : IEC_BACNET_STATUS

This function retreives the requested kinds of properties for the given list of objects from the specified device instance.

This procedure will read the object-list property of the given device instance if no object-list was specified by the caller. It will use up to nMaxActions concurrent requests to receive the requested data from the objects. It will use different read-access services supported by the device to read the objects properties. NOTE: This is an async function which will not block the caller during its execution.

Return: IEC_BACNET_STATUS

InOut:

Scope

Name

Type

Comment

Return

BACnetRetrieveObjectData

IEC_BACNET_STATUS

Input

pRequest

POINTER TO IEC_BACNET_OBJECT_DATA_REQUEST

Pointer to information which specifies which objects from the device and which kind of properties should be retrieved to build the information requested.

pICallback

CmpEventMgr.ICmpEventCallback

Pointer to the event-callback interface. Event-callback argument type is EVT_BACNET_OBJECT_DATA_PROGRESS. Purpose documented in BACstack: Pointer to the user application callback funktion to inform about failures and progress information along with information about retrieved object data during the procedure execution.

pAPDUParams

POINTER TO IEC_BACNET_APDU_PROPERTIES

A pointer to the structure which contains a set of APDU properties to control the timing and size of transmitted frames for this request. It temporarily overwrites the global APDU settings made in the source device from which this request is sent and which parameters would control this request if this pointer is NULL.

pTransactionToken

POINTER TO BACnetAsyncTransactionToken

Transaction token of the asynchronous call - see BACnetAsyncTransactionToken.