RTI Connext .NET API (legacy)
Version 6.1.0
|
<<singleton>> <<interface>> Allows creation and destruction of DDS::DomainParticipant objects. More...
#include <managed_domain.h>
Public Member Functions | |
void | set_default_participant_qos (DomainParticipantQos^ qos) |
Sets the default DDS::DomainParticipantQos values for this domain participant factory. More... | |
void | set_default_participant_qos_with_profile (System::String^ library_name, System::String^ profile_name) |
<<extension>> Sets the default DDS::DomainParticipantQos values for this domain participant factory based on the input XML QoS profile. More... | |
void | get_default_participant_qos (DomainParticipantQos^ qos) |
Initializes the DDS::DomainParticipantQos instance with default values. More... | |
void | set_default_library (System::String^ library_name) |
<<extension>> Sets the default XML library for a DDS::DomainParticipantFactory. More... | |
System::String ^ | get_default_library () |
<<extension>> Gets the default XML library associated with a DDS::DomainParticipantFactory. More... | |
void | set_default_profile (System::String^ library_name, System::String^ profile_name) |
<<extension>> Sets the default XML profile for a DDS::DomainParticipantFactory. More... | |
System::String ^ | get_default_profile () |
<<extension>> Gets the default XML profile associated with a DDS::DomainParticipantFactory. More... | |
System::String ^ | get_default_profile_library () |
<<extension>> Gets the library where the default XML profile is contained for a DDS::DomainParticipantFactory. More... | |
void | get_participant_factory_qos_from_profile (DomainParticipantFactoryQos^ qos, System::String^ library_name, System::String^ profile_name) |
<<extension>> Gets the DDS::DomainParticipantFactoryQos values associated with the input XML QoS profile. More... | |
void | get_participant_qos_from_profile (DomainParticipantQos^ qos, System::String^ library_name, System::String^ profile_name) |
<<extension>> Gets the DDS::DomainParticipantQos values associated with the input XML QoS profile. More... | |
void | get_publisher_qos_from_profile (PublisherQos^ qos, System::String^ library_name, System::String^ profile_name) |
<<extension>> Gets the DDS::PublisherQos values associated with the input XML QoS profile. More... | |
void | get_subscriber_qos_from_profile (SubscriberQos^ qos, System::String^ library_name, System::String^ profile_name) |
<<extension>> Gets the DDS::SubscriberQos values associated with the input XML QoS profile. More... | |
void | get_datawriter_qos_from_profile (DataWriterQos^ qos, System::String^ library_name, System::String^ profile_name) |
<<extension>> Gets the DDS::DataWriterQos values associated with the input XML QoS profile. More... | |
void | get_datawriter_qos_from_profile_w_topic_name (DataWriterQos^ qos, System::String^ library_name, System::String^ profile_name, System::String^ topic_name) |
<<extension>> Gets the DDS::DataWriterQos values associated with the input XML QoS profile while applying topic filters to the input topic name. More... | |
void | get_datareader_qos_from_profile (DataReaderQos^ qos, System::String^ library_name, System::String^ profile_name) |
<<extension>> Gets the DDS::DataReaderQos values associated with the input XML QoS profile. More... | |
void | get_datareader_qos_from_profile_w_topic_name (DataReaderQos^ qos, System::String^ library_name, System::String^ profile_name, System::String^ topic_name) |
<<extension>> Gets the DDS::DataReaderQos values associated with the input XML QoS profile while applying topic filters to the input topic name. More... | |
void | get_topic_qos_from_profile (TopicQos^ qos, System::String^ library_name, System::String^ profile_name) |
<<extension>> Gets the DDS::TopicQos values associated with the input XML QoS profile. More... | |
void | get_topic_qos_from_profile_w_topic_name (TopicQos^ qos, System::String^ library_name, System::String^ profile_name, System::String^ topic_name) |
<<extension>> Gets the DDS::TopicQos values associated with the input XML QoS profile while applying topic filters to the input topic name. More... | |
void | get_qos_profile_libraries (StringSeq^ library_names) |
<<extension>> Gets the names of all XML QoS profile libraries associated with the DDS::DomainParticipantFactory More... | |
void | get_qos_profiles (StringSeq^ profile_names, System::String^ library_name) |
<<extension>> Gets the names of all XML QoS profiles associated with the input XML QoS profile library. More... | |
DDS::TypeCode ^ | get_typecode_from_config (System::String^ type_name) |
<<extension>> Gets a DDS::TypeCode from a definition provided in an XML configuration file. More... | |
DomainParticipant ^ | create_participant (System::Int32 domainId, DomainParticipantQos^ qos, DomainParticipantListener^ listener, StatusMask mask) |
Creates a new DDS::DomainParticipant object. More... | |
DomainParticipant ^ | create_participant_with_profile (System::Int32 domainId, System::String^ library_name, System::String^ profile_name, DomainParticipantListener^ listener, StatusMask mask) |
<<extension>> Creates a new DDS::DomainParticipant object using the DDS::DomainParticipantQos associated with the input XML QoS profile. More... | |
void | delete_participant (DomainParticipant^% a_participant) |
Deletes an existing DDS::DomainParticipant. More... | |
DomainParticipant ^ | lookup_participant (Int32 domainId) |
Locates an existing DDS::DomainParticipant. More... | |
void | set_qos (DomainParticipantFactoryQos^ qos) |
Sets the value for a participant factory QoS. More... | |
void | get_qos (DomainParticipantFactoryQos^ qos) |
Gets the value for participant factory QoS. More... | |
void | load_profiles () |
<<extension>> Loads the XML QoS profiles. More... | |
void | reload_profiles () |
<<extension>> Reloads the XML QoS profiles. More... | |
void | unload_profiles () |
<<extension>> Unloads the XML QoS profiles. More... | |
void | unregister_thread () |
<<extension>> Allows the user to release thread specific resources kept by the middleware. More... | |
DomainParticipant ^ | create_participant_from_config (String^ configuration_name) |
<<extension>> Creates a DDS::DomainParticipant given its configuration name from a description provided in an XML configuration file. More... | |
DomainParticipant ^ | create_participant_from_config_w_params (String^ configuration_name, DomainParticipantConfigParams_t^ params) |
<<extension>> Creates a DDS::DomainParticipant given its configuration name from a description provided in an XML configuration file and a set of parameters that allow chaging some properties of such configuration. More... | |
DomainParticipant ^ | lookup_participant_by_name (String^ participant_name) |
<<extension>> Looks up a DDS::DomainParticipant by its entity name in the DDS::DomainParticipantFactory. More... | |
void | register_type_support (TypeSupport^ type_support, String^ type_name) |
<<extension>> Registers a DDS::TypeSupport with the DDS::DomainParticipantFactory to enable automatic registration if the corresponding type, should it be needed by a DDS::DomainParticipant. More... | |
Static Public Member Functions | |
static DomainParticipantFactory ^ | get_instance () |
Gets the singleton instance of this class. More... | |
static void | finalize_instance () |
<<extension>> Destroys the singleton instance of this class. More... | |
Properties | |
static DomainParticipantQos^ | PARTICIPANT_QOS_DEFAULT [get] |
Special value for creating a DomainParticipant with default QoS. More... | |
static DomainParticipantConfigParams_t^ | PARTICIPANT_CONFIG_PARAMS_DEFAULT [get] |
Special value for creating a DDS::DomainParticipant from configuration using default parameters. More... | |
<<singleton>> <<interface>> Allows creation and destruction of DDS::DomainParticipant objects.
The sole purpose of this class is to allow the creation and destruction of DDS::DomainParticipant objects. This class itself is a <<singleton>>, and accessed via the get_instance() method, and destroyed with finalize_instance() method.
A single application can participate in multiple domains by instantiating multiple DDS::DomainParticipant objects.
An application may even instantiate multiple participants in the same domain. Participants in the same domain exchange data in the same way regardless of whether they are in the same application or different applications or on the same node or different nodes; their location is transparent.
There are two important caveats:
|
static |
Gets the singleton instance of this class.
Referenced by RTI.Connext.Queuing.QueueConsumer< TRep >::QueueConsumer().
|
static |
<<extension>> Destroys the singleton instance of this class.
Only necessary to explicitly reclaim resources used by the participant factory singleton. Note that on many OSs, these resources are automatically reclaimed by the OS when the program terminates. However, some memory-check tools still flag these as unreclaimed. So this method provides a way to clean up memory used by the participant factory.
One | of the Standard Return Codes, or DDS::Retcode_PreconditionNotMet |
void DDS::DomainParticipantFactory::set_default_participant_qos | ( | DomainParticipantQos^ | qos | ) |
Sets the default DDS::DomainParticipantQos values for this domain participant factory.
This method may potentially allocate memory depending on the sequences contained in some QoS policies.
qos | <<inout>> Qos to be filled up. The special value DDS::DomainParticipantFactory::PARTICIPANT_QOS_DEFAULT may be passed as qos to indicate that the default QoS should be reset back to the initial values the factory would used if DDS::DomainParticipantFactory::set_default_participant_qos had never been called. Cannot be NULL. |
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::set_default_participant_qos_with_profile | ( | System::String^ | library_name, |
System::String^ | profile_name | ||
) |
<<extension>> Sets the default DDS::DomainParticipantQos values for this domain participant factory based on the input XML QoS profile.
This method may potentially allocate memory depending on the sequences contained in some QoS policies.
This default value will be used for newly created DDS::DomainParticipant if DDS::DomainParticipantFactory::PARTICIPANT_QOS_DEFAULT is specified as the qos
parameter when DDS::DomainParticipantFactory::create_participant is called.
library_name | <<in>> Library name containing the XML QoS profile. If library_name is null RTI Connext will use the default library (see DDS::DomainParticipantFactory::set_default_library). |
profile_name | <<in>> XML QoS Profile name. If profile_name is null RTI Connext will use the default profile (see DDS::DomainParticipantFactory::set_default_profile). |
If the input profile cannot be found the method fails with DDS::Retcode_Error.
One | of the Standard Return Codes, or DDS::Retcode_InconsistentPolicy |
void DDS::DomainParticipantFactory::get_default_participant_qos | ( | DomainParticipantQos^ | qos | ) |
Initializes the DDS::DomainParticipantQos instance with default values.
The retrieved qos
will match the set of values specified on the last successful call to DDS::DomainParticipantFactory::set_default_participant_qos, or DDS::DomainParticipantFactory::set_default_participant_qos_with_profile, or else, if the call was never made, the default values listed in DDS::DomainParticipantQos.
This method may potentially allocate memory depending on the sequences contained in some QoS policies.
qos | <<out>> the domain participant's QoS Cannot be NULL. |
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::set_default_library | ( | System::String^ | library_name | ) |
<<extension>> Sets the default XML library for a DDS::DomainParticipantFactory.
Any API requiring a library_name as a parameter can use null to refer to the default library set with this function.
Note: if the library set with this function no longer exists after reloading the QoS profiles (for example, by changing DDS::DomainParticipantFactoryQos::profile) the default library will be set to the last library containing a profile with the attribute is_default_qos=true
or null no such library exists.
library_name | <<in>> Library name. If library_name is null any previous default is unset. |
One | of the Standard Return Codes |
System::String ^ DDS::DomainParticipantFactory::get_default_library | ( | ) |
<<extension>> Gets the default XML library associated with a DDS::DomainParticipantFactory.
is_default_qos="true"
, this function returns the library where the last one is contained. void DDS::DomainParticipantFactory::set_default_profile | ( | System::String^ | library_name, |
System::String^ | profile_name | ||
) |
<<extension>> Sets the default XML profile for a DDS::DomainParticipantFactory.
This method specifies the profile that will be used as the default the next time a default DomainParticipantFactory profile is needed during a call to a DomainParticipantFactory method. When calling a DDS::DomainParticipantFactory method that requires a profile_name
parameter, you can use null to refer to the default profile. (This same information applies to setting a default library.)
This method does not set the default QoS for newly created DomainParticipants; for this functionality, use DDS::DomainParticipantFactory::set_default_participant_qos_with_profile (you may pass in null after having called set_default_profile()).
Note: if the profile set with this function no longer exists after reloading the QoS profiles (for example, by changing DDS::DomainParticipantFactoryQos::profile) the default profile will be set to the last one marked with the attribute is_default_qos=true
or null no such profile exists.
library_name | <<in>> The library name containing the profile. |
profile_name | <<in>> The profile name. If profile_name is null any previous default is unset. |
One | of the Standard Return Codes |
System::String ^ DDS::DomainParticipantFactory::get_default_profile | ( | ) |
<<extension>> Gets the default XML profile associated with a DDS::DomainParticipantFactory.
is_default_qos="true"
, this function returns the name of one of them System::String ^ DDS::DomainParticipantFactory::get_default_profile_library | ( | ) |
<<extension>> Gets the library where the default XML profile is contained for a DDS::DomainParticipantFactory.
The default profile library is automatically set when DDS::DomainParticipantFactory::set_default_profile is called.
This library can be different than the DDS::DomainParticipantFactory default library (see DDS::DomainParticipantFactory::get_default_library).
void DDS::DomainParticipantFactory::get_participant_factory_qos_from_profile | ( | DomainParticipantFactoryQos^ | qos, |
System::String^ | library_name, | ||
System::String^ | profile_name | ||
) |
<<extension>> Gets the DDS::DomainParticipantFactoryQos values associated with the input XML QoS profile.
qos | <<out>> Qos to be filled up. Cannot be NULL. |
library_name | <<in>> Library name containing the XML QoS profile. If library_name is null RTI Connext will use the default library (see DDS::DomainParticipantFactory::set_default_library). |
profile_name | <<in>> XML QoS Profile name. If profile_name is null RTI Connext will use the default profile (see DDS::DomainParticipantFactory::set_default_profile). |
If the input profile cannot be found, the method fails with DDS::Retcode_Error.
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::get_participant_qos_from_profile | ( | DomainParticipantQos^ | qos, |
System::String^ | library_name, | ||
System::String^ | profile_name | ||
) |
<<extension>> Gets the DDS::DomainParticipantQos values associated with the input XML QoS profile.
qos | <<out>> Qos to be filled up. Cannot be NULL. |
library_name | <<in>> Library name containing the XML QoS profile. If library_name is null RTI Connext will use the default library (see DDS::DomainParticipantFactory::set_default_library). |
profile_name | <<in>> XML QoS Profile name. If profile_name is null RTI Connext will use the default profile (see DDS::DomainParticipantFactory::set_default_profile). |
If the input profile cannot be found, the method fails with DDS::Retcode_Error.
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::get_publisher_qos_from_profile | ( | PublisherQos^ | qos, |
System::String^ | library_name, | ||
System::String^ | profile_name | ||
) |
<<extension>> Gets the DDS::PublisherQos values associated with the input XML QoS profile.
qos | <<out>> Qos to be filled up. Cannot be NULL. |
library_name | <<in>> Library name containing the XML QoS profile. If library_name is null RTI Connext will use the default library (see DDS::DomainParticipantFactory::set_default_library). |
profile_name | <<in>> XML QoS Profile name. If profile_name is null RTI Connext will use the default profile (see DDS::DomainParticipantFactory::set_default_profile). |
If the input profile cannot be found, the method fails with DDS::Retcode_Error.
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::get_subscriber_qos_from_profile | ( | SubscriberQos^ | qos, |
System::String^ | library_name, | ||
System::String^ | profile_name | ||
) |
<<extension>> Gets the DDS::SubscriberQos values associated with the input XML QoS profile.
qos | <<out>> Qos to be filled up. Cannot be NULL. |
library_name | <<in>> Library name containing the XML QoS profile. If library_name is null RTI Connext will use the default library (see DDS::DomainParticipantFactory::set_default_library). |
profile_name | <<in>> XML QoS Profile name. If profile_name is null RTI Connext will use the default profile (see DDS::DomainParticipantFactory::set_default_profile). |
If the input profile cannot be found, the method fails with DDS::Retcode_Error.
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::get_datawriter_qos_from_profile | ( | DataWriterQos^ | qos, |
System::String^ | library_name, | ||
System::String^ | profile_name | ||
) |
<<extension>> Gets the DDS::DataWriterQos values associated with the input XML QoS profile.
qos | <<out>> Qos to be filled up. Cannot be NULL. |
library_name | <<in>> Library name containing the XML QoS profile. If library_name is null RTI Connext will use the default library (see DDS::DomainParticipantFactory::set_default_library). |
profile_name | <<in>> XML QoS Profile name. If profile_name is null RTI Connext will use the default profile (see DDS::DomainParticipantFactory::set_default_profile). |
If the input profile cannot be found, the method fails with DDS::Retcode_Error.
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::get_datawriter_qos_from_profile_w_topic_name | ( | DataWriterQos^ | qos, |
System::String^ | library_name, | ||
System::String^ | profile_name, | ||
System::String^ | topic_name | ||
) |
<<extension>> Gets the DDS::DataWriterQos values associated with the input XML QoS profile while applying topic filters to the input topic name.
qos | <<out>> Qos to be filled up. Cannot be NULL. |
library_name | <<in>> Library name containing the XML QoS profile. If library_name is null RTI Connext will use the default library (see DDS::DomainParticipantFactory::set_default_library). |
profile_name | <<in>> XML QoS Profile name. If profile_name is null RTI Connext will use the default profile (see DDS::DomainParticipantFactory::set_default_profile). |
topic_name | <<in>> Topic name that will be evaluated against the topic_filter attribute in the XML QoS profile. If topic_name is null, RTI Connext will match only QoSs without explicit topic_filter expressions. |
If the input profile cannot be found, the method fails with DDS::Retcode_Error.
One | of the Standard Return Codes |
Referenced by RTI.Connext.Queuing.QueueConsumer< TRep >::QueueConsumer().
void DDS::DomainParticipantFactory::get_datareader_qos_from_profile | ( | DataReaderQos^ | qos, |
System::String^ | library_name, | ||
System::String^ | profile_name | ||
) |
<<extension>> Gets the DDS::DataReaderQos values associated with the input XML QoS profile.
qos | <<out>> Qos to be filled up. Cannot be NULL. |
library_name | <<in>> Library name containing the XML QoS profile. If library_name is null RTI Connext will use the default library (see DDS::DomainParticipantFactory::set_default_library). |
profile_name | <<in>> XML QoS Profile name. If profile_name is null RTI Connext will use the default profile (see DDS::DomainParticipantFactory::set_default_profile). |
If the input profile cannot be found, the method fails with DDS::Retcode_Error.
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::get_datareader_qos_from_profile_w_topic_name | ( | DataReaderQos^ | qos, |
System::String^ | library_name, | ||
System::String^ | profile_name, | ||
System::String^ | topic_name | ||
) |
<<extension>> Gets the DDS::DataReaderQos values associated with the input XML QoS profile while applying topic filters to the input topic name.
qos | <<out>> Qos to be filled up. Cannot be NULL. |
library_name | <<in>> Library name containing the XML QoS profile. If library_name is null RTI Connext will use the default library (see DDS::DomainParticipantFactory::set_default_library). |
profile_name | <<in>> XML QoS Profile name. If profile_name is null RTI Connext will use the default profile (see DDS::DomainParticipantFactory::set_default_profile). |
topic_name | <<in>> Topic name that will be evaluated against the topic_filter attribute in the XML QoS profile. If topic_name is null, RTI Connext will match only QoSs without explicit topic_filter expressions. |
If the input profile cannot be found, the method fails with DDS::Retcode_Error.
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::get_topic_qos_from_profile | ( | TopicQos^ | qos, |
System::String^ | library_name, | ||
System::String^ | profile_name | ||
) |
<<extension>> Gets the DDS::TopicQos values associated with the input XML QoS profile.
qos | <<out>> Qos to be filled up. Cannot be NULL. |
library_name | <<in>> Library name containing the XML QoS profile. If library_name is null RTI Connext will use the default library (see DDS::DomainParticipantFactory::set_default_library). |
profile_name | <<in>> XML QoS Profile name. If profile_name is null RTI Connext will use the default profile (see DDS::DomainParticipantFactory::set_default_profile). |
If the input profile cannot be found, the method fails with DDS::Retcode_Error.
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::get_topic_qos_from_profile_w_topic_name | ( | TopicQos^ | qos, |
System::String^ | library_name, | ||
System::String^ | profile_name, | ||
System::String^ | topic_name | ||
) |
<<extension>> Gets the DDS::TopicQos values associated with the input XML QoS profile while applying topic filters to the input topic name.
qos | <<out>> Qos to be filled up. Cannot be NULL. |
library_name | <<in>> Library name containing the XML QoS profile. If library_name is null RTI Connext will use the default library (see DDS::DomainParticipantFactory::set_default_library). |
profile_name | <<in>> XML QoS Profile name. If profile_name is null RTI Connext will use the default profile (see DDS::DomainParticipantFactory::set_default_profile). |
topic_name | <<in>> Topic name that will be evaluated against the topic_filter attribute in the XML QoS profile. If topic_name is null, RTI Connext will match only QoSs without explicit topic_filter expressions. |
If the input profile cannot be found, the method fails with DDS::Retcode_Error.
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::get_qos_profile_libraries | ( | StringSeq^ | library_names | ) |
<<extension>> Gets the names of all XML QoS profile libraries associated with the DDS::DomainParticipantFactory
library_names | <<out>> DDS::StringSeq to be filled with names of XML QoS profile libraries. Cannot be NULL. |
void DDS::DomainParticipantFactory::get_qos_profiles | ( | StringSeq^ | profile_names, |
System::String^ | library_name | ||
) |
<<extension>> Gets the names of all XML QoS profiles associated with the input XML QoS profile library.
profile_names | <<out>> DDS::StringSeq to be filled with names of XML QoS profiles. Cannot be NULL. |
library_name | <<in>> Library name containing the XML QoS profile. If library_name is null RTI Connext will use the default library (see DDS::DomainParticipantFactory::set_default_library). |
DDS::TypeCode ^ DDS::DomainParticipantFactory::get_typecode_from_config | ( | System::String^ | type_name | ) |
<<extension>> Gets a DDS::TypeCode from a definition provided in an XML configuration file.
type_name | <<in>> Name of the type in the configuration file. |
DomainParticipant ^ DDS::DomainParticipantFactory::create_participant | ( | System::Int32 | domainId, |
DomainParticipantQos^ | qos, | ||
DomainParticipantListener^ | listener, | ||
StatusMask | mask | ||
) |
Creates a new DDS::DomainParticipant object.
If you want to create multiple participants on a given host in the same domain, make sure each one has a different participant index (set in the DDS::WireProtocolQosPolicy). This in turn will ensure each participant uses a different port number (since the unicast port numbers are calculated from the participant index and the domain ID).
Note that if there is a single participant per host in a given domain, the participant index can be left at the default value (-1).
domainId | <<in>> ID of the domain that the application intends to join. [range] [>=0], and does not violate guidelines stated in DDS::RtpsWellKnownPorts_t. |
qos | <<in>> the DomainParticipant's QoS. The special value DDS::DomainParticipantFactory::PARTICIPANT_QOS_DEFAULT can be used to indicate that the DDS::DomainParticipant should be created with the default DDS::DomainParticipantQos set in the DDS::DomainParticipantFactory. Cannot be NULL. |
listener | <<in>> the domain participant's listener. |
mask | <<in>>. Changes of communication status to be invoked on the listener. See DDS::StatusMask. |
DomainParticipant ^ DDS::DomainParticipantFactory::create_participant_with_profile | ( | System::Int32 | domainId, |
System::String^ | library_name, | ||
System::String^ | profile_name, | ||
DomainParticipantListener^ | listener, | ||
StatusMask | mask | ||
) |
<<extension>> Creates a new DDS::DomainParticipant object using the DDS::DomainParticipantQos associated with the input XML QoS profile.
If you want to create multiple participants on a given host in the same domain, make sure each one has a different participant index (set in the DDS::WireProtocolQosPolicy). This in turn will ensure each participant uses a different port number (since the unicast port numbers are calculated from the participant index and the domain ID).
Note that if there is a single participant per host in a given domain, the participant index can be left at the default value (-1).
domainId | <<in>> ID of the domain that the application intends to join. [range] [>=0], and does not violate guidelines stated in DDS::RtpsWellKnownPorts_t. |
library_name | <<in>> Library name containing the XML QoS profile. If library_name is null RTI Connext will use the default library (see DDS::DomainParticipantFactory::set_default_library). |
profile_name | <<in>> XML QoS Profile name. If profile_name is null RTI Connext will use the default profile (see DDS::DomainParticipantFactory::set_default_profile). |
listener | <<in>> the DomainParticipant's listener. |
mask | <<in>>. Changes of communication status to be invoked on the listener. See DDS::StatusMask. |
void DDS::DomainParticipantFactory::delete_participant | ( | DomainParticipant^% | a_participant | ) |
Deletes an existing DDS::DomainParticipant.
a_participant | <<in>> DDS::DomainParticipant to be deleted. |
One | of the Standard Return Codes, or DDS::Retcode_PreconditionNotMet. |
DomainParticipant ^ DDS::DomainParticipantFactory::lookup_participant | ( | Int32 | domainId | ) |
Locates an existing DDS::DomainParticipant.
If no such DDS::DomainParticipant exists, the operation will return NULL value.
If multiple DDS::DomainParticipant entities belonging to that domainId exist, then the operation will return one of them. It is not specified which one.
domainId | <<in>> ID of the domain participant to lookup. |
void DDS::DomainParticipantFactory::set_qos | ( | DomainParticipantFactoryQos^ | qos | ) |
Sets the value for a participant factory QoS.
The DDS::DomainParticipantFactoryQos::entity_factory can be changed. The other policies are immutable.
Note that despite having QoS, the DDS::DomainParticipantFactory is not an DDS::Entity.
qos | <<in>> Set of policies to be applied to DDS::DomainParticipantFactory. Policies must be consistent. Immutable policies can only be changed before calling any other RTI Connext methods except for DDS::DomainParticipantFactory::get_qos Cannot be NULL. |
One | of the Standard Return Codes, DDS::Retcode_ImmutablePolicy if immutable policy is changed, or DDS::Retcode_InconsistentPolicy if policies are inconsistent |
void DDS::DomainParticipantFactory::get_qos | ( | DomainParticipantFactoryQos^ | qos | ) |
Gets the value for participant factory QoS.
qos | <<inout>> QoS to be filled up. Cannot be NULL. |
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::load_profiles | ( | ) |
<<extension>> Loads the XML QoS profiles.
The XML QoS profiles are loaded implicitly after the first DDS::DomainParticipant is created or explicitly, after a call to this method.
This has the same effect as DDS::DomainParticipantFactory::reload_profiles().
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::reload_profiles | ( | ) |
<<extension>> Reloads the XML QoS profiles.
The XML QoS profiles are loaded implicitly after the first DDS::DomainParticipant is created or explicitly, after a call to this method.
This has the same effect as DDS::DomainParticipantFactory::load_profiles().
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::unload_profiles | ( | ) |
<<extension>> Unloads the XML QoS profiles.
The resources associated with the XML QoS profiles are freed. Any reference to the profiles after calling this method will fail with an error.
One | of the Standard Return Codes |
void DDS::DomainParticipantFactory::unregister_thread | ( | ) |
<<extension>> Allows the user to release thread specific resources kept by the middleware.
This function should be called by the user right before exiting a thread where DDS API were used. In this way the middleware will be able to free all the resources related to this specific thread. The best approach is to call the function during the thread deletion after all the DDS related API have have been called.
One | of the Standard Return Codes |
DomainParticipant ^ DDS::DomainParticipantFactory::create_participant_from_config | ( | String^ | configuration_name | ) |
<<extension>> Creates a DDS::DomainParticipant given its configuration name from a description provided in an XML configuration file.
This operation creates a DDS::DomainParticipant registering all the necessary data types and creating all the contained entities (DDS::Topic, DDS::Publisher, DDS::Subscriber, DDS::DataWriter, DDS::DataReader) from a description given in an XML configuration file.
The configuration name is the fully qualified name of the XML participant object, consisting of the name of the participant library plus the name of participant configuration.
For example the name "MyParticipantLibrary::PublicationParticipant" can be used to create the domain participant from the description in an XML file with contents shown in the snippet below:
The entities belonging to the newly created DDS::DomainParticipant can be retrieved with the help of lookup operations such as: DDS::DomainParticipant::lookup_datareader_by_name.
This operation is equivalent to call DDS::DomainParticipantFactory::create_participant_from_config_w_params passing DDS::DomainParticipantFactory::PARTICIPANT_CONFIG_PARAMS_DEFAULT as parameters.
configuration_name | <<in>> Name of the participant configuration in the XML file. |
DomainParticipant ^ DDS::DomainParticipantFactory::create_participant_from_config_w_params | ( | String^ | configuration_name, |
DomainParticipantConfigParams_t^ | params | ||
) |
<<extension>> Creates a DDS::DomainParticipant given its configuration name from a description provided in an XML configuration file and a set of parameters that allow chaging some properties of such configuration.
The operation will create a DDS::DomainParticipant the same way specified in DDS::DomainParticipantFactory::create_participant_from_config.
In addition, this operation allows overriding the domain ID, participant name, and entities QoS specified in the configuration.
configuration_name | <<in>> Name of the participant configuration in the XML file. |
params | <<in>> input parameters that allow changing some properties of the configuration referred to by configuration_name . |
DomainParticipant ^ DDS::DomainParticipantFactory::lookup_participant_by_name | ( | String^ | participant_name | ) |
<<extension>> Looks up a DDS::DomainParticipant by its entity name in the DDS::DomainParticipantFactory.
Every DDS::DomainParticipant in the system has an entity name which is configured and stored in the EntityName policy, ENTITY_NAME.
This operation retrieves a DDS::DomainParticipant within the DDS::DomainParticipantFactory given the entity's name. If there are several DDS::DomainParticipant with the same name within the DDS::DomainParticipantFactory this function returns the first matching occurrence.
participant_name | <<in>> Entity name of the DDS::DomainParticipant. |
void DDS::DomainParticipantFactory::register_type_support | ( | TypeSupport^ | type_support, |
String^ | type_name | ||
) |
<<extension>> Registers a DDS::TypeSupport with the DDS::DomainParticipantFactory to enable automatic registration if the corresponding type, should it be needed by a DDS::DomainParticipant.
Types refered by the DDS::Topic entities within a DDS::DomainParticipant must be registered with the DDS::DomainParticipant.
Type registration in a DDS::DomainParticipant is performed by a call to the FooTypeSupport::register_type operation. This can be done directly from the application code or indirectly by the RTI Connext infrastructure as a result of parsing an XML configuration file that refers to that type.
The DDS::DomainParticipantFactory::register_type_support operation provides the DDS::DomainParticipantFactory with the information it needs to automatically call the FooTypeSupport::register_type operation and register the corresponding type if the type is needed as a result of parsing an XML configuration file.
Automatic type registration while parsing XML files can also be done by the RTI Connext infrastructure based on the type description provided in the XML files. If the DDS::TypeSupport has been registered with the DDS::DomainParticipantFactory this definition takes precedence over the description of the type given in the XML file.
The DDS::DomainParticipantFactory::register_type_support operation receives a FooTypeSupport object as a parameter. This object's class is normally generated using rtiddsgen from a description of the corresponsing type in IDL, XML, or XSD.
The typical workflow when using this function is as follows: Define the data-type in IDL (or XML, or XSD) in a file. E.g. Foo.idl Run rtiddsgen in that file to generate the TypeSupport files, for the desired programming language. E.g. in C++ FooTypeSupport.h FooTypeSupport.cxx Include the proper header file (e.g. FooTypeSupport.h) in your program and call DDS::DomainParticipantFactory::register_type_support passing the function that was generated by rtiddsgen. E.g. FooTypeSupport::register_type Include the TypeSupport source file in your project such that it is compiled and linked. E.g. FooTypeSupport.cxx
You may refer to the Getting Started Guide for additional details in this process.
Note that only one register function is allowed per registered type name.
type_support | <<in>> DDS::TypeSupport object to be used for registering the type with a DDS::DomainParticipant. |
type_name | <<in>> Name the type is registered with. |
One | of the Standard Return Codes |