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

<<cert>> QoS policies supported by a DDS_Subscriber entity. More...

#include <dds_c_subscription.h>

Data Fields

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

Detailed Description

<<cert>> QoS policies supported by a DDS_Subscriber entity.

You must set the members in a consistent manner. If not, DDS_Subscriber_set_qos and DDS_DomainParticipant_set_default_subscriber_qos will fail with DDS_RETCODE_INCONSISTENT_POLICY, and DDS_DomainParticipant_create_subscriber will fail.

Field Documentation

◆ entity_factory

struct DDS_EntityFactoryQosPolicy DDS_SubscriberQos::entity_factory

Entity factory policy, ENTITY_FACTORY.

◆ partition

struct DDS_PartitionQosPolicy DDS_SubscriberQos::partition

The DDS_Subscriber 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 DDS_Subscriber. DDS_DataReader belong to the PARTITIONs of the DDS_Subscriber 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 DDS_DomainParticipant: - 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 DDS_Subscriber_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