BACnetStack_SendGetEventInformation
bool BACnetStack_SendGetEventInformation( uint8_t * sentInvokeId, const bool useLastReceivedObjectIdentifier, const uint16_t lastReceivedObjectType, const uint32_t lastReceivedObjectInstance, const uint8_t * connectionString, const uint8_t connectionStringLength, const uint32_t networkPortInstance, const uint16_t destinationNetwork, const uint8_t * destinationAddress, const uint8_t destinationAddressLength);Sends a GetEventInformation request (cl. 13.12) to enumerate a device’s active events.
Paged: pass useLastReceivedObjectIdentifier=true with the last object from the previous ACK to fetch the next page.
See also: Client response hooks
BACnet reference: ANSI/ASHRAE 135-2024 clause 13.12 (GetEventInformation Service).
Parameters
Section titled “Parameters”| Parameter | Direction | Description |
|---|---|---|
sentInvokeId |
out | The invoke-id of the sent request, valid only if this function returns true. |
useLastReceivedObjectIdentifier, lastReceivedObjectType, lastReceivedObjectInstance |
in | The paging cursor - pass useLastReceivedObjectIdentifier=false for the first page. The type and instance are one BACnet Object Identifier carried as two parameters (see the API conventions). |
connectionString, connectionStringLength |
in | The datalink address to send TO (the destination) - not the local address to send from. For IPv4 this is 6 bytes: 4 octets of IPv4 address followed by 2 octets of port, big-endian (e.g. 0xC0,0xA8,0x01,0x05,0xBA,0xC0 = 192.168.1.5:47808; see BACnetStack_SendRegisterForeignDevice() for a worked example); on BACnet/IPv4 the stack refuses to send to a connection string of any other length, except that a broadcast from a device registered as a foreign device goes to its BBMD and does not use the connection string. MS/TP and BACnet/SC use a different connection-string shape; see their respective Set/Send exports. |
networkPortInstance |
in | The Network Port object instance to send the message on, or BACNET_NETWORK_PORT_DEFAULT (4194303) for the default/single port. |
destinationNetwork, destinationAddress, destinationAddressLength |
in | The destination to send the request to. |
Returns
Section titled “Returns”True if the request was sent, otherwise false.
Topic: Client requests. Declared in CASBACnetStackDLL.h.