RTI Connext C++ API  Version 5.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.
 

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 4 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

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 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.

[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.

RTI Connext C++ API Version 5.0.0 Copyright © Thu Aug 30 2012 Real-Time Innovations, Inc