RTI Connext .Net APIs  Version 6.0.1
DDS::DataRepresentationQosPolicy Class Reference

This QoS policy contains a list of representation identifiers used by DDS::DataWriter and DDS::DataReader entities to negotiate which data representation to use. More...

#include <managed_infrastructure.h>

Static Public Member Functions

static System::String ^ get_data_representation_qos_policy_name ()
 Stringified human-readable name for DDS::DataRepresentationQosPolicy. More...
 

Public Attributes

ShortSeqvalue
 Sequence of representation identifiers. More...
 

Static Public Attributes

static System::Int16 XCDR_DATA_REPRESENTATION
 Corresponds to the Extended Common Data Representation encoding version 1. More...
 
static System::Int16 XML_DATA_REPRESENTATION
 Corresponds to the XML Data Representation (unsupported). More...
 
static System::Int16 XCDR2_DATA_REPRESENTATION
 Corresponds to the Extended Common Data Representation encoding version 2. More...
 
static System::Int16 AUTO_DATA_REPRESENTATION
 Representation is automatically chosen based on the type. More...
 

Detailed Description

This QoS policy contains a list of representation identifiers used by DDS::DataWriter and DDS::DataReader entities to negotiate which data representation to use.

Entity:
DDS::Topic, DDS::DataReader, DDS::DataWriter
Status:
DDS::StatusKind::OFFERED_INCOMPATIBLE_QOS_STATUS, DDS::StatusKind::REQUESTED_INCOMPATIBLE_QOS_STATUS
Properties:
RxO = YES
Changeable = UNTIL ENABLE
See also
DATA_REPRESENTATION

This policy has request-offer semantics. A DDS::DataWriter may only offer a single representation. Attempting to put multiple representations in a DDS::DataWriter will result in DDS::Retcode_InconsistentPolicy. A DDS::DataWriter will use its offered policy to communicate with its matched DDS::DataReader entities. A DDS::DataReader requests one or more representations. If a DDS::DataWriter offers a representation that is contained within the sequence of the DDS::DataReader, the offer satisfies the request and the policies are compatible. Otherwise, they are incompatible.

When representations are specified in the DDS::TopicQos, DDS::Publisher::copy_from_topic_qos copies the first element of the sequence, and DDS::Subscriber::copy_from_topic_qos copies the whole sequence.

Member Data Documentation

◆ value

ShortSeq ^ DDS::DataRepresentationQosPolicy::value

Sequence of representation identifiers.

[default] For DDS::Topic, DDS::DataWriter, and DDS::DataReader, a list with one element: DDS::DataRepresentationId_t::AUTO_DATA_REPRESENTATION.

Note
An empty sequence is equivalent to a list with one element: DDS::DataRepresentationId_t::XCDR_DATA_REPRESENTATION.

RTI Connext .Net APIs Version 6.0.1 Copyright © Sat Nov 23 2019 Real-Time Innovations, Inc