EVT_BACNET_OS_TIME_PROVIDER (STRUCT)

TYPE EVT_BACNET_OS_TIME_PROVIDER : STRUCT

Declaration of the system clock or system time providing callback function.

This callback provided by the user application gives the BACnet API the opportunity to request a valid system clock or system time in case that the OS specific functions like time() or gettimeofday() are not working properly.

Return: ::BACNET_OS_TIME_PROVIDER

InOut:

Name

Type

Comment

pCBReturn

POINTER TO IEC_BACNET_OS_TIME_PROVIDER

Return for the event ::BACNET_OS_TIME_PROVIDER

bTimeRequested

IEC_BACNET_BOOLEAN

If set to True the BACnet API requests the actual system time by the user application. In case that the user application can provide the current system time it shall set the bTimeIsValid member and fill the time part correctly. If the user application is unable to fill the time part it shall return a NULL pointer in the callback.n If set to False the BACnet API requests the sequence number and the user application should fill the nSequenceNumber member correctly and set the bTimeIsValid member to False.n The BACnet API will automatically ask for the sequence number if the previously callback for requesting the time couldn’t be answered.