RTI Connext Micro C++ API Version 4.3.0
Loading...
Searching...
No Matches
DDS_SubscriberQos Struct Reference

QoS policies supported by a DDSSubscriber entity. More...

#include <dds_c_subscription.h>

Public Attributes

struct DDS_EntityFactoryQosPolicy entity_factory
 Entity factory policy, ENTITY_FACTORY.
 
struct DDS_PartitionQosPolicy partition
 The DDSSubscriber PARTITION policy.
 
struct DDS_GroupDataQosPolicy group_data
 Group data policy, GROUP_DATA.
 
struct DDS_EntityNameQosPolicy subscriber_name
 <<eXtension>> The DDSSubscriber name. ENTITY_NAME.
 

Detailed Description

QoS policies supported by a DDSSubscriber entity.

You must set the members in a consistent manner. If not, DDSSubscriber::set_qos and DDSDomainParticipant::set_default_subscriber_qos will fail with DDS_RETCODE_INCONSISTENT_POLICY, and DDSDomainParticipant::create_subscriber will fail.

Member Data Documentation

◆ entity_factory

struct DDS_EntityFactoryQosPolicy DDS_SubscriberQos::entity_factory

Entity factory policy, ENTITY_FACTORY.

◆ partition

struct DDS_PartitionQosPolicy DDS_SubscriberQos::partition

The DDSSubscriber PARTITION policy.

A set of strings that introduces logical PARTITIONs.

Only entities that belong to the same PARTITION can communicate to each other. The PARTITION QoS policy applies directly to the DDSSubscriber. DDSDataReader belong to the PARTITIONs of the DDSSubscriber that created them.

The default PARTITION during initialization is the empty string, "".

The number and size of partitions are bounded by the DDS_DomainParticipantResourceLimitsQosPolicy settings configured on the DDSDomainParticipant: - DDS_DomainParticipantResourceLimitsQosPolicy::max_partitions: maximum number of partition name elements (default 64, cannot exceed 64). - DDS_DomainParticipantResourceLimitsQosPolicy::max_partition_cumulative_characters: maximum total characters across all partition names including NUL terminators (default 256, cannot exceed 256). - DDS_DomainParticipantResourceLimitsQosPolicy::max_partition_string_size: maximum characters in a single partition name (default DDS_LENGTH_UNLIMITED).

Exceeding any of these limits causes DDSSubscriber::set_qos to return DDS_RETCODE_INCONSISTENT_POLICY.

See also
DDS_DomainParticipantResourceLimitsQosPolicy

PARTITION

◆ group_data

struct DDS_GroupDataQosPolicy DDS_SubscriberQos::group_data

Group data policy, GROUP_DATA.

◆ subscriber_name

struct DDS_EntityNameQosPolicy DDS_SubscriberQos::subscriber_name