RTI Connext C API  Version 5.3.1
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
DDS_DataReaderQos Struct Reference

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

Data Fields

struct DDS_DurabilityQosPolicy durability
 Durability policy, DURABILITY.
 
struct DDS_DeadlineQosPolicy deadline
 Deadline policy, DEADLINE.
 
struct DDS_LatencyBudgetQosPolicy latency_budget
 Latency budget policy, LATENCY_BUDGET.
 
struct DDS_LivelinessQosPolicy liveliness
 Liveliness policy, LIVELINESS.
 
struct DDS_ReliabilityQosPolicy reliability
 Reliability policy, RELIABILITY.
 
struct
DDS_DestinationOrderQosPolicy 
destination_order
 Destination order policy, DESTINATION_ORDER.
 
struct DDS_HistoryQosPolicy history
 History policy, HISTORY.
 
struct DDS_ResourceLimitsQosPolicy resource_limits
 Resource limits policy, RESOURCE_LIMITS.
 
struct DDS_UserDataQosPolicy user_data
 User data policy, USER_DATA.
 
struct DDS_OwnershipQosPolicy ownership
 Ownership policy, OWNERSHIP.
 
struct DDS_TimeBasedFilterQosPolicy time_based_filter
 Time-based filter policy, TIME_BASED_FILTER.
 
struct
DDS_ReaderDataLifecycleQosPolicy 
reader_data_lifecycle
 Reader data lifecycle policy, READER_DATA_LIFECYCLE.
 
struct
DDS_TypeConsistencyEnforcementQosPolicy 
type_consistency
 Type consistency enforcement policy, TYPE_CONSISTENCY_ENFORCEMENT.
 
struct
DDS_DataReaderResourceLimitsQosPolicy 
reader_resource_limits
 <<extension>> DDS_DataReader resource limits policy, DATA_READER_RESOURCE_LIMITS. This policy is an extension to the DDS standard.
 
struct
DDS_DataReaderProtocolQosPolicy 
protocol
 <<extension>> DDS_DataReader protocol policy, DATA_READER_PROTOCOL
 
struct
DDS_TransportSelectionQosPolicy 
transport_selection
 <<extension>> Transport selection policy, TRANSPORT_SELECTION.
 
struct
DDS_TransportUnicastQosPolicy 
unicast
 <<extension>> Unicast transport policy, TRANSPORT_UNICAST.
 
struct
DDS_TransportMulticastQosPolicy 
multicast
 <<extension>> Multicast transport policy, TRANSPORT_MULTICAST.
 
struct DDS_PropertyQosPolicy property
 <<extension>> Property policy, PROPERTY.
 
struct DDS_ServiceQosPolicy service
 <<extension>> Service policy, SERVICE.
 
struct DDS_AvailabilityQosPolicy availability
 <<extension>> Availability policy, AVAILABILITY.
 
struct DDS_EntityNameQosPolicy subscription_name
 <<extension>> EntityName policy, ENTITY_NAME.
 
struct
DDS_TransportPriorityQosPolicy 
transport_priority
 Transport priority policy, TRANSPORT_PRIORITY.
 
struct DDS_TypeSupportQosPolicy type_support
 <<extension>> type support data, TYPESUPPORT.
 

Detailed Description

QoS policies supported by a DDS_DataReader entity.

You must set certain members in a consistent manner:

DDS_DataReaderQos::deadline .period >= DDS_DataReaderQos::time_based_filter .minimum_separation

DDS_DataReaderQos::history .depth <= DDS_DataReaderQos::resource_limits .max_samples_per_instance

DDS_DataReaderQos::resource_limits .max_samples_per_instance <= DDS_DataReaderQos::resource_limits .max_samples DDS_DataReaderQos::resource_limits .initial_samples <= DDS_DataReaderQos::resource_limits .max_samples

DDS_DataReaderQos::resource_limits .initial_instances <= DDS_DataReaderQos::resource_limits .max_instances

DDS_DataReaderQos::reader_resource_limits .initial_remote_writers_per_instance <= DDS_DataReaderQos::reader_resource_limits .max_remote_writers_per_instance

DDS_DataReaderQos::reader_resource_limits .initial_infos <= DDS_DataReaderQos::reader_resource_limits .max_infos

DDS_DataReaderQos::reader_resource_limits .max_remote_writers_per_instance <= DDS_DataReaderQos::reader_resource_limits .max_remote_writers

DDS_DataReaderQos::reader_resource_limits .max_samples_per_remote_writer <= DDS_DataReaderQos::resource_limits .max_samples

length of DDS_DataReaderQos::user_data .value <= DDS_DomainParticipantQos::resource_limits .reader_user_data_max_length

If any of the above are not true, DDS_DataReader_set_qos and DDS_DataReader_set_qos_with_profile will fail with DDS_RETCODE_INCONSISTENT_POLICY and DDS_Subscriber_create_datareader will return NULL.

Field Documentation

struct DDS_DurabilityQosPolicy DDS_DataReaderQos::durability

Durability policy, DURABILITY.

struct DDS_DeadlineQosPolicy DDS_DataReaderQos::deadline

Deadline policy, DEADLINE.

struct DDS_LatencyBudgetQosPolicy DDS_DataReaderQos::latency_budget

Latency budget policy, LATENCY_BUDGET.

struct DDS_LivelinessQosPolicy DDS_DataReaderQos::liveliness

Liveliness policy, LIVELINESS.

struct DDS_ReliabilityQosPolicy DDS_DataReaderQos::reliability

Reliability policy, RELIABILITY.

struct DDS_DestinationOrderQosPolicy DDS_DataReaderQos::destination_order

Destination order policy, DESTINATION_ORDER.

struct DDS_HistoryQosPolicy DDS_DataReaderQos::history

History policy, HISTORY.

struct DDS_ResourceLimitsQosPolicy DDS_DataReaderQos::resource_limits

Resource limits policy, RESOURCE_LIMITS.

struct DDS_UserDataQosPolicy DDS_DataReaderQos::user_data

User data policy, USER_DATA.

struct DDS_OwnershipQosPolicy DDS_DataReaderQos::ownership

Ownership policy, OWNERSHIP.

struct DDS_TimeBasedFilterQosPolicy DDS_DataReaderQos::time_based_filter

Time-based filter policy, TIME_BASED_FILTER.

struct DDS_ReaderDataLifecycleQosPolicy DDS_DataReaderQos::reader_data_lifecycle

Reader data lifecycle policy, READER_DATA_LIFECYCLE.

struct DDS_TypeConsistencyEnforcementQosPolicy DDS_DataReaderQos::type_consistency

Type consistency enforcement policy, TYPE_CONSISTENCY_ENFORCEMENT.

struct DDS_DataReaderResourceLimitsQosPolicy DDS_DataReaderQos::reader_resource_limits

<<extension>> DDS_DataReader resource limits policy, DATA_READER_RESOURCE_LIMITS. This policy is an extension to the DDS standard.

struct DDS_DataReaderProtocolQosPolicy DDS_DataReaderQos::protocol
struct DDS_TransportSelectionQosPolicy DDS_DataReaderQos::transport_selection

<<extension>> Transport selection policy, TRANSPORT_SELECTION.

Specifies the transports available for use by the DDS_DataReader.

struct DDS_TransportUnicastQosPolicy DDS_DataReaderQos::unicast

<<extension>> Unicast transport policy, TRANSPORT_UNICAST.

Specifies the unicast transport interfaces and ports on which messages can be received.

The unicast interfaces are used to receive messages from DDS_DataWriter entities in the domain.

struct DDS_TransportMulticastQosPolicy DDS_DataReaderQos::multicast

<<extension>> Multicast transport policy, TRANSPORT_MULTICAST.

Specifies the multicast group addresses and ports on which messages can be received.

The multicast addresses are used to receive messages from DDS_DataWriter entities in the domain.

struct DDS_PropertyQosPolicy DDS_DataReaderQos::property

<<extension>> Property policy, PROPERTY.

struct DDS_ServiceQosPolicy DDS_DataReaderQos::service

<<extension>> Service policy, SERVICE.

struct DDS_AvailabilityQosPolicy DDS_DataReaderQos::availability

<<extension>> Availability policy, AVAILABILITY.

struct DDS_EntityNameQosPolicy DDS_DataReaderQos::subscription_name

<<extension>> EntityName policy, ENTITY_NAME.

struct DDS_TransportPriorityQosPolicy DDS_DataReaderQos::transport_priority

Transport priority policy, TRANSPORT_PRIORITY.

struct DDS_TypeSupportQosPolicy DDS_DataReaderQos::type_support

<<extension>> type support data, TYPESUPPORT.

Optional value that is passed to a type plugin's on_endpoint_attached and deserialization functions.


RTI Connext C API Version 5.3.1 Copyright © Mon Feb 19 2018 Real-Time Innovations, Inc