DomainParticipantFactory constructs DomainParticipants. More...
Public Member Functions | |
DomainParticipant | create_participant (uint domain_id, DomainParticipantQos qos, DomainParticipantListener listener, uint mask) |
Creates a DomainParticipant. | |
ReturnCode_t | delete_participant (DomainParticipant participant) |
Destroys the provided DomainParticipant. | |
DomainParticipant | lookup_participant (uint domain_id) |
Returns a previously created DomainParticipant belonging to the specified domain_id. | |
ReturnCode_t | set_default_participant_qos (DomainParticipantQos qos) |
Sets the default DDS.DomainParticipantQos held in the factory. | |
ReturnCode_t | get_default_participant_qos (DomainParticipantQos qos) |
Provides access to the default Participant qos held in the factory. | |
ReturnCode_t | set_qos (DomainParticipantFactoryQos qos) |
Sets the DomainParticipantFactory QoS values. | |
ReturnCode_t | get_qos (DomainParticipantFactoryQos qos) |
Provides access to the QoS settings of the DomainParticipantFactory. | |
ReturnCode_t | set_license (string lic) |
Configures the license file or license string to enable CoreDX DDS. | |
ReturnCode_t | set_license_debug (bool debug) |
Enables debug output from the CoreDX DDS run-time license system. | |
Static Public Member Functions | |
static DomainParticipantFactory | get_instance () |
Properties | |
static DomainParticipantFactory | Instance [get] |
DomainParticipantFactory constructs DomainParticipants.
The DomainParticipantFactory is used to configure, create and destroy DomainParticipant instances.
DomainParticipant create_participant | ( | uint | domain_id, | |
DomainParticipantQos | qos, | |||
DomainParticipantListener | listener, | |||
uint | mask | |||
) | [inline] |
Creates a DomainParticipant.
This operation creates a new DomainParticipant object. The caller provides the domain_id to which the Participant should belong. The listener and mask arguments are used to specify a set of callback routines which will be invoked upon detection of certain events. The qos argument specifies the DomainParticipant Quality of Service settings that should be used when creating the DomainParticipant. It may be specified as DDS.PARTICIPANT_QOS_DEFAULT to instruct CoreDX to use the default qos settings held in the DomainParticipantFactory. This routine will return NULL if it fails to create a DomainParticipant.
ReturnCode_t delete_participant | ( | DomainParticipant | participant | ) | [inline] |
Destroys the provided DomainParticipant.
This routine will fail if all Entities (Publishers, Subscribers, etc) created through the specified DomainParticipant have not yet been deleted. (In this case, RETCODE_PRECONDITION_NOT_MET will be returned.)
ReturnCode_t get_default_participant_qos | ( | DomainParticipantQos | qos | ) | [inline] |
Provides access to the default Participant qos held in the factory.
The provided qos argument is populated with the default qos settings.
static DomainParticipantFactory get_instance | ( | ) | [inline, static] |
Get access to the singleton DomainParticipantFactory.
DomainParticipant lookup_participant | ( | uint | domain_id | ) | [inline] |
Returns a previously created DomainParticipant belonging to the specified domain_id.
If there are multiple DomainParticipants in existence within the specified domain, one of them will be returned.
ReturnCode_t set_default_participant_qos | ( | DomainParticipantQos | qos | ) | [inline] |
Sets the default DDS.DomainParticipantQos held in the factory.
This default qos will be used during subsequent calls to DDS.DomainParticipantFactory.create_participant() if the special DDS.PARTICIPANT_QOS_DEFAULT value is provided for qos.
This routine may fail if the provided qos argument is not internally consistent. In this case, DDS.RETCODE_INCONSISTENT_POLICY will be returned, and no changes will be made to the DomainParticipantFactory.
ReturnCode_t set_license | ( | string | lic | ) | [inline] |
Configures the license file or license string to enable CoreDX DDS.
CoreDX DDS normally requires a license to run. This license can be sepecified several ways:
ReturnCode_t set_license_debug | ( | bool | debug | ) | [inline] |
Enables debug output from the CoreDX DDS run-time license system.
This routine will configure CoreDX DDS to generate debug information in processing the license at run-time. The 'deubg' parameter may be either: 'nonzero' to enable debug output or 'zero' to disable debug ouput.
ReturnCode_t set_qos | ( | DomainParticipantFactoryQos | qos | ) | [inline] |
Sets the DomainParticipantFactory QoS values.
These QoS values affect the behavior of the factory.
This routine may fail if the provided qos argument is not internally consistent. In this case, DDS.INCONSISTENT_POLICY will be returned, and no changes will be made to the DomainParticipantFactory.
DomainParticipantFactory Instance [static, get] |
A C# style property with accessor. use it like this: DomainParticipantFactory.Instance.create_participant()