RTI Connext Traditional C++ API  Version 7.0.0
DDS_TransportSelectionQosPolicy Struct Reference

Specifies the physical transports a DDSDataWriter or DDSDataReader may use to send or receive data. More...

Public Attributes

struct DDS_StringSeq enabled_transports
 A sequence of transport aliases that specifies the transport instances available for use by the entity. More...
 

Detailed Description

Specifies the physical transports a DDSDataWriter or DDSDataReader may use to send or receive data.

An application may be simultaneously connected to many different physical transports, e.g., Ethernet, Infiniband, shared memory, VME backplane, and wireless. By default, RTI Connext will use up to 16 transports to deliver data from a DataWriter to a DataReader.

This QoS policy can be used to both limit and control which of the application's available transports may be used by a DDSDataWriter to send data or by a DDSDataReader to receive data.

Entity:
DDSDataReader, DDSDataWriter
Properties:
RxO = N/A
Changeable = NO

Member Data Documentation

◆ enabled_transports

struct DDS_StringSeq DDS_TransportSelectionQosPolicy::enabled_transports

A sequence of transport aliases that specifies the transport instances available for use by the entity.

Of the transport instances installed with the DDSDomainParticipant, only those with aliases matching an alias in this sequence are available to the entity.

Thus, this list of aliases sub-selects from the transports available to the DDSDomainParticipant.

An empty sequence is a special value that specifies all the transports installed with the DDSDomainParticipant.

The memory for the strings in this sequence is managed according to the conventions described in String Conventions. In particular, be careful to avoid a situation in which RTI Connext allocates a string on your behalf and you then reuse that string in such a way that RTI Connext believes it to have more memory allocated to it than it actually does.

Alias names for the builtin transports are defined in TRANSPORT_BUILTIN. These alias names are case sensitive and should be written in lowercase.

[default] Empty sequence; i.e. all the transports installed with and available to the DDSDomainParticipant.

[range] A sequence of non-null,non-empty strings.

See also
DDS_DomainParticipantQos::transport_builtin.