BACnetRetrieveListOfNetworkDevices (FUN)¶

FUNCTION BACnetRetrieveListOfNetworkDevices : IEC_BACNET_STATUS

This function retreives a list of network devices which are found during the network scan.

The scan procedure will use BACnet dynamic device binding services to discover devices in the requested instance range and will read specified properties from the device object and also the list of objects in the device along with additional properties from the objects if requested. NOTE: This is an async function which will not block the caller.

Return: IEC_BACNET_STATUS

InOut:

Scope	Name	Type	Comment
Return	`BACnetRetrieveListOfNetworkDevices`	IEC_BACNET_STATUS
Input	`pRequest`	POINTER TO IEC_BACNET_DEVICE_LIST_REQUEST	Pointer to information which specifies which network and device instance range and which kind of properties should be scanned and read to build the information requested.
	`pICallback`	`CmpEventMgr.ICmpEventCallback`	Pointer to the event-callback interface. Event-callback argument type is EVT_BACNET_DEVICE_LIST_PROGRESS. Purpose documented in BACstack: Pointer to the user application callback funktion to inform about failures and progress information along with information about detected devices 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.