EVT_BACNET_CONFEVENTNOTIFICATION (STRUCT)

TYPE EVT_BACNET_CONFEVENTNOTIFICATION : STRUCT

Receives confirmed Intrinsic Alarm and Event notification requests.

This is the type declaration for the Confirmed Event Notification service application hook. This hook allows a BACnet application to process Confirm Event Notification service since there are no default processing of this service in the present API version. This hook is given all of the parameters of a service request, and is responsible for all error checking (object existence, correspondence of parameters, address correctness and any other service parameter given). A pointer to the routine is registered by BACnetSetHook. A hook can be registered at any time. One hook procedure is registered per service. If a hook is registered more than once for the same service, the new hook procedure replaces the old one. A NULL procedure pointer can be used to unregister the hook. A Confirmed Event Notification hook must complete its service request processing by using one of the transaction completion API routines: BACnetSrvcResponseCbCompletion, BACnetSrvcAbortCbCompletion, BACnetSrvcErrorCbCompletion or BACnetSrvcRejectCbCompletion.

InOut:

Name

Type

Comment

pCBStatus

POINTER TO IEC_BACNET_CB_STATUS

CB-Status returned for the event. “Default” processes the standard APIs reaction, which needs no additional Callback-Signalling.

phTransaction

POINTER TO BYTE

This is the Transaction State Machine (TSM) handle for the current service request. It is generated by the BACnet API and is the first parameter given to the Hook- Completion functions.

sourceAddress

POINTER TO IEC_BACNET_ADDRESS

This is the MAC address of the BACnet addressed device from which the request has been sent.

destinationAddress

POINTER TO IEC_BACNET_ADDRESS

This is the MAC address of the device constructed by the application which has received the request.

pServiceInfo

POINTER TO IEC_BACNET_EVENT_NOTIF_INFO

A pointer to the service information data structure. This data structure is of data type BACNET_EVENT_NOTIF_INFO.