RTI Connext .NET API (legacy)  Version 6.1.1

<<extension>> Specifies the discovery configuration QoS. More...

Classes

struct  DDS::BuiltinTopicReaderResourceLimits_t
 Built-in topic reader's resource limits. More...
 
class  DDS::DiscoveryConfigQosPolicy
 Settings for discovery configuration. More...
 

Enumerations

enum  DDS::DiscoveryConfigBuiltinPluginKind : UINT32 {
  DDS::DiscoveryConfigBuiltinPluginKind::DISCOVERYCONFIG_BUILTIN_SPDP,
  DDS::DiscoveryConfigBuiltinPluginKind::DISCOVERYCONFIG_BUILTIN_SEDP,
  DDS::DiscoveryConfigBuiltinPluginKind::DISCOVERYCONFIG_BUILTIN_SDP,
  DDS::DiscoveryConfigBuiltinPluginKind::DISCOVERYCONFIG_BUILTIN_EDS,
  DDS::DiscoveryConfigBuiltinPluginKind::DISCOVERYCONFIG_BUILTIN_PLUGIN_MASK_ALL,
  DDS::DiscoveryConfigBuiltinPluginKind::DISCOVERYCONFIG_BUILTIN_PLUGIN_MASK_NONE,
  DDS::DiscoveryConfigBuiltinPluginKind::DISCOVERYCONFIG_BUILTIN_PLUGIN_MASK_DEFAULT
}
 Built-in discovery plugins that can be used. More...
 
enum  DDS::RemoteParticipantPurgeKind : UINT32 {
  DDS::RemoteParticipantPurgeKind::LIVELINESS_BASED_REMOTE_PARTICIPANT_PURGE,
  DDS::RemoteParticipantPurgeKind::NO_REMOTE_PARTICIPANT_PURGE
}
 Available behaviors for halting communication with remote participants (and their contained entities) with which discovery communication has been lost. More...
 

Functions

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

Detailed Description

<<extension>> Specifies the discovery configuration QoS.

Enumeration Type Documentation

◆ DiscoveryConfigBuiltinPluginKind

Built-in discovery plugins that can be used.

See also
DDS::DiscoveryConfigQosPolicy::builtin_discovery_plugins
Enumerator
DISCOVERYCONFIG_BUILTIN_SPDP 

Simple Participant Discovery Protocol.

Enables the first phase of the Simple Discovery Protocol (SDP), in which DomainParticipant's details are communicated to all other DomainParticipants in the same DDS domain by sending participant declaration messages, also known as participant DATA submessages or participant announcements.

DISCOVERYCONFIG_BUILTIN_SEDP 

Simple Endpoint Discovery Protocol.

Enables the second phase of the Simple Discovery Protocol (SDP), in which the information (GUID, QoS, etc.) about your application's DataReaders and DataWriters is exchanged by sending publication/subscription declarations in DATA messages, also known as publication DATAs and subscription DATAs.

DISCOVERYCONFIG_BUILTIN_SDP 

[default] Simple discovery plugin.

It is equivalent to SPDP + SEDP.

DISCOVERYCONFIG_BUILTIN_EDS 

Enterprise Discovery Service.

Including this value in DDS::DiscoveryConfigQosPolicy::builtin_discovery_plugins requires Enterprise Discovery Service (EDS), an add-on product that provides participant-matching services. Please contact suppo.nosp@m.rt@r.nosp@m.ti.co.nosp@m.m for more information.

DISCOVERYCONFIG_BUILTIN_PLUGIN_MASK_ALL 

All bits are set.

See also
DDS::DiscoveryConfigQosPolicy::builtin_discovery_plugins
DISCOVERYCONFIG_BUILTIN_PLUGIN_MASK_NONE 

No bits are set.

See also
DDS::DiscoveryConfigQosPolicy::builtin_discovery_plugins
DISCOVERYCONFIG_BUILTIN_PLUGIN_MASK_DEFAULT 

The default value of DDS::DiscoveryConfigQosPolicy::builtin_discovery_plugins.

See also
DDS::DiscoveryConfigQosPolicy::builtin_discovery_plugins

◆ RemoteParticipantPurgeKind

enum DDS::RemoteParticipantPurgeKind : UINT32
strong

Available behaviors for halting communication with remote participants (and their contained entities) with which discovery communication has been lost.

When discovery communication with a remote participant has been lost, the local participant must make a decision about whether to continue attempting to communicate with that participant and its contained entities. This "kind" is used to select the desired behavior.

This "kind" does not pertain to the situation in which a remote participant has been gracefully deleted and notification of that deletion have been successfully received by its peers. In that case, the local participant will immediately stop attempting to communicate with those entities and will remove the associated remote entity records from its internal database.

See also
DDS::DiscoveryConfigQosPolicy::remote_participant_purge_kind
Enumerator
LIVELINESS_BASED_REMOTE_PARTICIPANT_PURGE 

[default] Maintain knowledge of the remote participant for as long as it maintains its liveliness contract.

A participant will continue attempting communication with its peers, even if discovery communication with them is lost, as long as the remote participants maintain their liveliness. If both discovery communication and participant liveliness are lost, however, the local participant will remove all records of the remote participant and its contained endpoints, and no further data communication with them will occur until and unless they are rediscovered.

The liveliness contract a participant promises to its peers – its "liveliness lease duration" – is specified in its DDS::DiscoveryConfigQosPolicy::participant_liveliness_lease_duration QoS field. It maintains that contract by writing data to those other participants with a writer that has a DDS::LivelinessQosPolicyKind of AUTOMATIC_LIVELINESS_QOS or MANUAL_BY_PARTICIPANT_LIVELINESS_QOS and by asserting itself (at the DDS::DiscoveryConfigQosPolicy::participant_liveliness_assert_period) over the Simple Discovery Protocol.

NO_REMOTE_PARTICIPANT_PURGE 

Never "forget" a remote participant with which discovery communication has been lost.

If a participant with this behavior loses discovery communication with a remote participant, it will nevertheless remember that remote participant and its endpoints and continue attempting to communicate with them indefinitely.

This value has consequences for a participant's resource usage. If discovery communication with a remote participant is lost, but the same participant is later rediscovered, any relevant records that remain in the database will be reused. However, if it is not rediscovered, the records will continue to take up space in the database for as long as the local participant remains in existence.

Function Documentation

◆ get_discoveryconfig_qos_policy_name()

static System::String ^ DDS::DiscoveryConfigQosPolicy::get_discoveryconfig_qos_policy_name ( )
inlinestatic

Stringified human-readable name for DDS::DiscoveryConfigQosPolicy.