BACnetStack_SetMaxActiveCOVSubscriptions

bool BACnetStack_SetMaxActiveCOVSubscriptions(
  const uint32_t deviceInstance,
  const uint32_t maxNumberOfSubscriptions);

Sets the maximum number of active COV subscriptions that a server device can contain.

The capacity half of BACnetStack_SetCOVSettings(); it does not change the COV lifetime.

IT SETS BOTH SUBSCRIPTION TABLES. The value is applied to the SubscribeCOV / SubscribeCOVProperty table and, in a build with SubscribeCOVPropertyMultiple (STACK_OPTION_SUBSCRIBE_COV_PROPERTY_MULTIPLE), to the SubscribeCOVPropertyMultiple table as well, replacing any capacity an earlier BACnetStack_SetCOVMultipleSettings() call gave it. To give the SubscribeCOVPropertyMultiple table its own capacity, call BACnetStack_SetCOVMultipleSettings() AFTER this function.

Note

Requires one of the build options STACK_OPTION_DS_COVU_B, STACK_OPTION_DS_COV_SUBSCRIBE_COV (any of them turns on STACK_OPTION_SUBSCRIBE_COV, the macro this function checks).

BACnet reference: ANSI/ASHRAE 135-2024 clause 13.1 (Change of Value Reporting).

Parameters

Parameter	Direction	Description
deviceInstance	in	The instance of the device to configure.
maxNumberOfSubscriptions	in	The maximum number of active COV subscriptions to support. If set to zero, no limit.

Returns

True if successful, false if failed.

Topic: Device and services. Declared in CASBACnetStackDLL.h.