EVT_BACNET_DEVICE_LIST_PROGRESS (STRUCT)¶

TYPE EVT_BACNET_DEVICE_LIST_PROGRESS : STRUCT

Prototype definition for the callback function which provides the device information to the application for detected network devices.

This callback is called on a successful scan completion or on any error condition for every detected device in the scanned network that matched the selected instance range.

::BAC_BOOLEAN If the user callback returns FALSE here the current scan procedure is cancelled and no further callbacks will be issued.

InOut:

Name	Type	Comment
`pCBReturn`	POINTER TO IEC_BACNET_BOOLEAN	Return for the event. ::BAC_BOOLEAN If the user callback returns FALSE here the current scan procedure is cancelled and no further callbacks will be issued.
`phTransaction`	POINTER TO BYTE	The handle which identifies the transaction handled by the user application. The given handle has to be unique, in case the application needs to separate multiple pending requests. This handle is transparent for the BACnet API and is returned unchanged to the user application in the completion function callback. This handle may be NULL, but the user application will be unable to cancel pending requests by a call to ::BACnetCancelPendingConfirmedRequest or to separate them in the callback if multiple completions are pending in such case.
`status`	IEC_BACNET_STATUS	Contains the current status of operation. A value != ::BACNET_STATUS_OK represents an error condition. Additional information may be available in pError if the error is related to communication problems.
`pError`	POINTER TO IEC_BACNET_ERROR	Contains the most recent BACnet error occurred during the process. Only valid if status has not the value BACNET_STATUS_OK.
`pInfo`	POINTER TO IEC_BACNET_DEVICE_DISCOVERY_INFO	Pointer to structure containing all requested device and optionally also object information along with possible device ID or MAC address or routing collisions detected during network scanning.
`nDevicesFound`	IEC_BACNET_UINT	Number of devices found during network scan. This value may increase between different callbacks because new devices may be discovered.
`nDevicesProcessed`	IEC_BACNET_UINT	Number of devices which have been scanned and processed.
`bProcedureFinished`	IEC_BACNET_BOOLEAN	This parameter is TRUE if the scan procedure has been completed successfully or not and the request is complete. If the user application cancelles the processing no completion callback will be issued.