RTI Connext C API  Version 5.0.0
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_AvailabilityQosPolicy availability
 <<eXtension>> Availability policy, AVAILABILITY.
 
struct DDS_EntityNameQosPolicy subscription_name
 <<eXtension>> EntityName policy, ENTITY_NAME.
 
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

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_AvailabilityQosPolicy DDS_DataReaderQos::availability

<<eXtension>> Availability policy, AVAILABILITY.

struct DDS_EntityNameQosPolicy DDS_DataReaderQos::subscription_name

<<eXtension>> EntityName policy, ENTITY_NAME.

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.0.0 Copyright © Thu Aug 30 2012 Real-Time Innovations, Inc