RTI Connext Micro C API  Version 2.4.14.1
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups
DDS_DataWriterQos Struct Reference

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

Data Fields

struct DDS_DeadlineQosPolicy deadline
 Deadline policy, DEADLINE.
struct DDS_LivelinessQosPolicy liveliness
 Liveliness policy, LIVELINESS.
struct DDS_HistoryQosPolicy history
 History policy, HISTORY.
struct DDS_ResourceLimitsQosPolicy resource_limits
 Resource limits policy, RESOURCE_LIMITS.
struct DDS_OwnershipQosPolicy ownership
 Ownership policy, OWNERSHIP.
struct
DDS_OwnershipStrengthQosPolicy 
ownership_strength
 Ownership strength policy, OWNERSHIP_STRENGTH.
struct DDS_ReliabilityQosPolicy reliability
 Reliability policy, RELIABILITY.
struct DDS_DurabilityQosPolicy durability
 <<eXtension>> Durability policy, DURABILITY.
struct
DDS_DestinationOrderQosPolicy 
destination_order
 <<eXtension>> Destination Order policy, DESTINATION_ORDER.
struct
DDS_DataWriterProtocolQosPolicy 
protocol
 <<eXtension>> DDS_DataWriter protocol policy, DATA_WRITER_PROTOCOL
struct DDS_TransportQosPolicy transport
 Transport policy, TRANSPORT. Only unicast transports are supported.
struct
DDS_DataWriterResourceLimitsQosPolicy 
writer_resource_limits
 Writer resource limits policy, DataWriter Resource Limits.

Detailed Description

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

The DDS_DataWriterQos controls the resources allocated by a DDS_DataWriter. Each DDS_DataWriter allocates its own resources, even DataWriters of the same DDS_Topic. For this reason is it advised to limit the number of DataWriters per topic.

You must set certain members in a consistent manner:

- DDS_DataWriterQos::DDS_HistoryQosPolicy::depth <= DDS_DataWriterQos::DDS_ResourceLimitsQosPolicy::max_samples_per_instance

- DDS_DataWriterQos::DDS_ResourceLimitsQosPolicy::max_samples_per_instance <= DDS_DataWriterQos::DDS_ResourceLimitsQosPolicy::max_samples

If any of the above are not true, DDS_DataWriter_set_qos and DDS_Publisher_set_default_datawriter_qos will fail with DDS_RETCODE_INCONSISTENT_POLICY and DDS_Publisher_create_datawriter and will return NULL.

Entity:
DDS_DataWriter
See also:
QoS Policies allowed ranges within each Qos.

Field Documentation

struct DDS_DeadlineQosPolicy DDS_DataWriterQos::deadline

Deadline policy, DEADLINE.

struct DDS_LivelinessQosPolicy DDS_DataWriterQos::liveliness

Liveliness policy, LIVELINESS.

struct DDS_HistoryQosPolicy DDS_DataWriterQos::history

History policy, HISTORY.

struct DDS_ResourceLimitsQosPolicy DDS_DataWriterQos::resource_limits

Resource limits policy, RESOURCE_LIMITS.

struct DDS_OwnershipQosPolicy DDS_DataWriterQos::ownership

Ownership policy, OWNERSHIP.

struct DDS_OwnershipStrengthQosPolicy DDS_DataWriterQos::ownership_strength

Ownership strength policy, OWNERSHIP_STRENGTH.

struct DDS_ReliabilityQosPolicy DDS_DataWriterQos::reliability

Reliability policy, RELIABILITY.

struct DDS_DurabilityQosPolicy DDS_DataWriterQos::durability

<<eXtension>> Durability policy, DURABILITY.

struct DDS_DestinationOrderQosPolicy DDS_DataWriterQos::destination_order

<<eXtension>> Destination Order policy, DESTINATION_ORDER.

struct DDS_DataWriterProtocolQosPolicy DDS_DataWriterQos::protocol
struct DDS_TransportQosPolicy DDS_DataWriterQos::transport

Transport policy, TRANSPORT. Only unicast transports are supported.

struct DDS_DataWriterResourceLimitsQosPolicy DDS_DataWriterQos::writer_resource_limits

Writer resource limits policy, DataWriter Resource Limits.


RTI Connext Micro C API Version 2.4.14.1 Copyright © Thu Nov 2 2023 Real-Time Innovations, Inc