WIRE_PROTOCOL

<<extension>> Specifies the wire protocol related attributes for the DDS::DomainParticipant. More...

Classes
struct	DDS::RtpsWellKnownPorts_t
	RTPS well-known port mapping configuration. More...
struct	DDS::WireProtocolQosPolicy
	Specifies the wire-protocol-related attributes for the DDS::DomainParticipant. More...

Enumerations
enum	DDS::RtpsReservedPortKind : UINT32
	RTPS reserved port kind, used to identify the types of ports that can be reserved on domain participant enable. More...
enum	DDS::WireProtocolQosPolicyAutoKind : UINT32
	Mechanism to automatically calculate the GUID prefix. More...

Functions
static System::String^	DDS::WireProtocolQosPolicy::get_wireprotocol_qos_policy_name ()
	Stringified human-readable name for DDS::WireProtocolQosPolicy.

Properties
static RtpsWellKnownPorts_t	DDS::RtpsWellKnownPorts_t::RTI_BACKWARDS_COMPATIBLE_RTPS_WELL_KNOWN_PORTS [get]
	Assign to use well-known port mappings which are compatible with previous versions of the RTI Connext middleware.
static RtpsWellKnownPorts_t	DDS::RtpsWellKnownPorts_t::INTEROPERABLE_RTPS_WELL_KNOWN_PORTS [get]
	Assign to use well-known port mappings which are compliant with OMG's DDS Interoperability Wire Protocol.
static System::UInt32	DDS::WireProtocolQosPolicy::RTPS_AUTO_ID [get]
	Indicates that RTI Connext should choose an appropriate host, app, instance or object ID automatically.

Detailed Description

<<extension>> Specifies the wire protocol related attributes for the DDS::DomainParticipant.

Enumeration Type Documentation

enum DDS::RtpsReservedPortKind : UINT32

RTPS reserved port kind, used to identify the types of ports that can be reserved on domain participant enable.

See Also

DDS::WireProtocolQosPolicy::rtps_reserved_port_mask

enum DDS::WireProtocolQosPolicyAutoKind : UINT32

Mechanism to automatically calculate the GUID prefix.

See Also

DDS::WireProtocolQosPolicy::rtps_auto_id_kind

Function Documentation

static System::String ^ DDS::WireProtocolQosPolicy::get_wireprotocol_qos_policy_name ( )

inlinestatic

Stringified human-readable name for DDS::WireProtocolQosPolicy.

Properties

RtpsWellKnownPorts_t DDS::RtpsWellKnownPorts_t::RTI_BACKWARDS_COMPATIBLE_RTPS_WELL_KNOWN_PORTS

staticget

Assign to use well-known port mappings which are compatible with previous versions of the RTI Connext middleware.

Assign DDS::WireProtocolQosPolicy::rtps_well_known_ports to this value to remain compatible with previous versions of the RTI Connext middleware that used fixed port mappings.

The following are the rtps_well_known_ports values for DDS::RtpsWellKnownPorts_t::RTI_BACKWARDS_COMPATIBLE_RTPS_WELL_KNOWN_PORTS:

port_base = 7400
domain_id_gain = 10
participant_id_gain = 1000
builtin_multicast_port_offset = 2
builtin_unicast_port_offset = 0
user_multicast_port_offset = 1
user_unicast_port_offset = 3

These settings are not compliant with OMG's DDS Interoperability Wire Protocol. To comply with the specification, please use DDS::RtpsWellKnownPorts_t::INTEROPERABLE_RTPS_WELL_KNOWN_PORTS.

See Also

DDS::WireProtocolQosPolicy::rtps_well_known_ports

DDS::RtpsWellKnownPorts_t::INTEROPERABLE_RTPS_WELL_KNOWN_PORTS

RtpsWellKnownPorts_t DDS::RtpsWellKnownPorts_t::INTEROPERABLE_RTPS_WELL_KNOWN_PORTS

staticget

Assign to use well-known port mappings which are compliant with OMG's DDS Interoperability Wire Protocol.

Assign DDS::WireProtocolQosPolicy::rtps_well_known_ports to this value to use well-known port mappings which are compliant with OMG's DDS Interoperability Wire Protocol.

The following are the rtps_well_known_ports values for DDS::RtpsWellKnownPorts_t::INTEROPERABLE_RTPS_WELL_KNOWN_PORTS:

port_base = 7400
domain_id_gain = 250
participant_id_gain = 2
builtin_multicast_port_offset = 0
builtin_unicast_port_offset = 10
user_multicast_port_offset = 1
user_unicast_port_offset = 11

Assuming a maximum port number of 65535 (UDPv4), the above settings enable the use of about 230 domains with up to 120 Participants per node per domain.

These settings are not backwards compatible with previous versions of the RTI Connext middleware that used fixed port mappings. For backwards compability, please use DDS::RtpsWellKnownPorts_t::RTI_BACKWARDS_COMPATIBLE_RTPS_WELL_KNOWN_PORTS.

See Also

DDS::WireProtocolQosPolicy::rtps_well_known_ports

DDS::RtpsWellKnownPorts_t::RTI_BACKWARDS_COMPATIBLE_RTPS_WELL_KNOWN_PORTS

static System::UInt32 DDS::WireProtocolQosPolicy::RTPS_AUTO_ID

staticget

Indicates that RTI Connext should choose an appropriate host, app, instance or object ID automatically.

If this special value is assigned to DDS::WireProtocolQosPolicy::rtps_host_id, DDS::WireProtocolQosPolicy::rtps_app_id, DDS::WireProtocolQosPolicy::rtps_instance_id, DDS::DataWriterProtocolQosPolicy::rtps_object_id or DDS::DataReaderProtocolQosPolicy::rtps_object_id RTI Connext will assign the ID automatically.

The actual ID value is chosen when the QoS is set: the QoS returned from DDS::DomainParticipant::get_qos, DDS::DataWriter::get_qos or DDS::DataReader::get_qos will never have this value.

QoS:

DDS::WireProtocolQosPolicy::rtps_host_id DDS::WireProtocolQosPolicy::rtps_app_id DDS::WireProtocolQosPolicy::rtps_instance_id