BACnetStack_SetCOVMultipleSettings

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

Sets ONLY the SubscribeCOVPropertyMultiple subscription-table capacity.

The parallel of BACnetStack_SetCOVSettings() and BACnetStack_SetMaxActiveCOVSubscriptions() (each of which sets BOTH the single-COV and the COVPropertyMultiple tables to one value, replacing what this function set): call one of them first for a common cap, then this to give the SubscribeCOVPropertyMultiple table its own capacity.

Capacity only - there is deliberately no COVPropertyMultiple lifetime parameter here. Despite the name symmetry with BACnetStack_SetCOVSettings(deviceInstance, maxSubscriptions, maxLifetime), this function takes two arguments, not three. The maximum supported COV lifetime is a single DEVICE-WIDE value, shared by SubscribeCOV and SubscribeCOVPropertyMultiple alike; set it with BACnetStack_SetCOVSettings() or BACnetStack_SetMaxSupportedCOVLifetime(). A third parameter here would imply a per-table lifetime knob that the stack does not model.

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); it has an effect only with STACK_OPTION_DS_COVM_SUBSCRIBE_COV_PROPERTY_MULTIPLE as well.

BACnet reference: ANSI/ASHRAE 135-2024 clause 13.16 (SubscribeCOVPropertyMultiple Service).

Parameters

Parameter	Direction	Description
deviceInstance	in	The instance of the device to configure.
maxNumberOfSubscriptions	in	Capacity of the SubscribeCOVPropertyMultiple table; 0 = unbounded.

Returns

True if successful; false if the device does not exist, or the stack was built without STACK_OPTION_SUBSCRIBE_COV. In a build without SubscribeCOVPropertyMultiple (STACK_OPTION_DS_COVM_SUBSCRIBE_COV_PROPERTY_MULTIPLE) there is no table to size: the call returns true for an existing device and changes nothing.

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