BACnetRegisterTimeProviderFunction (FUN)

FUNCTION BACnetRegisterTimeProviderFunction : IEC_BACNET_STATUS

Registers a user application callback to provide the BACnet API with correct system clock or system time information.

The user application gives the BACnet API the opportunity to request a valid system clock or system time on such OS plattforms which do not provide them in the standard funktions linke time() or gettimeofday(). The user application, on the other side, has so the opportunity to “simulate” the system clock or system time.n Please keep in mind that this callback might be called very often by the BACnet API if there are many time related actions configured.

InOut:

Scope

Name

Type

Comment

Return

BACnetRegisterTimeProviderFunction

IEC_BACNET_STATUS

Input

pICallback

CmpEventMgr.ICmpEventCallback

Pointer to the event-callback interface. Event-callback argument type is EVT_BACNET_OS_TIME_PROVIDER. Purpose documented in BACstack: A pointer to the user application callback function. A null pointer can be used to unregister the callback and use the default implementation.