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

<<extension>> DDS_DataReader protocol policy, DATA_READER_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.