DDS_ChannelSettings_t Struct Reference
[MULTICHANNEL]

Type used to configure the properties of a channel. More...

Data Fields
struct DDS_TransportMulticastSettingsSeq	multicast_settings
	A sequence of DDS_TransportMulticastSettings_t used to configure the multicast addresses associated with a channel.
char *	filter_expression
	A logical expression used to determine the data that will be published in the channel.

---

Detailed Description

Type used to configure the properties of a channel.

QoS:

DDS_MultiChannelQosPolicy

---

Field Documentation

struct DDS_TransportMulticastSettingsSeq DDS_ChannelSettings_t::multicast_settings [read]

A sequence of DDS_TransportMulticastSettings_t used to configure the multicast addresses associated with a channel.

The sequence cannot be empty.

The maximum number of multicast locators in a channel is limited to four (A locator is defined by a transport alias, a multicast address and a port)

[default] Empty sequence (invalid value)

char* DDS_ChannelSettings_t::filter_expression

A logical expression used to determine the data that will be published in the channel.

If the expression evaluates to TRUE, a sample will be published on the channel.

An empty string always evaluates the expression to TRUE.

A NULL value is not allowed.

The syntax of the expression will depend on the value of DDS_MultiChannelQosPolicy::filter_name

Important: This value must be an allocated string with DDS_String_alloc or DDS_String_dup. It should not be assigned to a string constant.

The filter expression length (including NULL-terminated character) cannot be greater than DDS_DomainParticipantResourceLimitsQosPolicy::channel_filter_expression_max_length.

See also:

Queries and Filters Syntax

[default] NULL (invalid value)