DDS_DomainParticipant Struct Reference
[DDS Entities]

The DDS_DomainParticipant is used to configure, create and destroy Publisher, Subscriber and Topic objects. More...

Related Functions
(Note that these are not member functions.)
DDS_ReturnCode_t	DDS_DomainParticipant_enable (DDS_DomainParticipant dp)
	Enables the DomainParticipant.
DDS_InstanceHandle_t	DDS_DomainParticipant_get_instance_handle (DDS_DomainParticipant dp)
	This operation returns the InstanceHandle_t that identifies the DomainParticipant.
DDS_StatusCondition	DDS_DomainParticipant_get_statuscondition (DDS_DomainParticipant dp)
	This operation allows access to the DDS_StatusCondition associated with the DomainParticipant.
DDS_StatusMask	DDS_DomainParticipant_get_status_changes (DDS_DomainParticipant dp)
	This returns the list of triggered communication statuses in the DomainParticipant.
DDS_Publisher	DDS_DomainParticipant_create_publisher (DDS_DomainParticipant dp, DDS_PublisherQos qos, DDS_PublisherListener a_listener, DDS_StatusMask mask)
	This operation creates a DDS_Publisher with the specified DDS_PublisherQoS settings and DDS_PublisherListener.
DDS_ReturnCode_t	DDS_DomainParticipant_delete_publisher (DDS_DomainParticipant dp, DDS_Publisher p)
	This operation deletes an existing DDS_Publisher.
DDS_Subscriber	DDS_DomainParticipant_create_subscriber (DDS_DomainParticipant dp, DDS_SubscriberQos qos, DDS_SubscriberListener a_listener, DDS_StatusMask mask)
	This operation creates a DDS_Subscriber with the specified DDS_SubscriberQos and DDS_SubscriberListener.
DDS_ReturnCode_t	DDS_DomainParticipant_delete_subscriber (DDS_DomainParticipant dp, DDS_Subscriber s)
	This operation deletes an existing DDS_Subscriber.
DDS_Subscriber	DDS_DomainParticipant_get_builtin_subscriber (struct _DomainParticipant *d)
	Returns the built-in DDS_Subscriber.
DDS_Topic	DDS_DomainParticipant_create_topic (DDS_DomainParticipant dp, const char topic_name, const char type_name, DDS_TopicQos qos, DDS_TopicListener a_listener, DDS_StatusMask mask)
	This operation creates a DDS_Topic with the specified DDS_TopicQos settings and DDS_TopicListener.
DDS_ReturnCode_t	DDS_DomainParticipant_delete_topic (DDS_DomainParticipant dp, DDS_Topic a_topic)
	This operation deletes a DDS_Topic.
DDS_Topic	DDS_DomainParticipant_find_topic (DDS_DomainParticipant dp, const char topic_name, DDS_Duration_t timeout)
	This operation returns a DDS_Topic identified by the provided topic_name.
DDS_TopicDescription	DDS_DomainParticipant_lookup_topicdescription (DDS_DomainParticipant dp, const char *name)
	This operation returns an existing, locally-created DDS_TopicDescription, named name.
DDS_ContentFilteredTopic	DDS_DomainParticipant_create_contentfilteredtopic (DDS_DomainParticipant dp, const char name, const DDS_Topic related_topic, const char filter_expression, const DDS_StringSeq *filter_parameters)
	This operation creates a ContentFilteredTopic.
DDS_ReturnCode_t	DDS_DomainParticipant_delete_contentfilteredtopic (DDS_DomainParticipant dp, DDS_ContentFilteredTopic a_contentfilteredtopic)
	This operation deletes a previously allocated ContentFilteredTopic.
DDS_MultiTopic	DDS_DomainParticipant_create_multitopic (DDS_DomainParticipant dp, const char name, const char type_name, const char subscription_expression, const DDS_StringSeq expression_parameters)
DDS_ReturnCode_t	DDS_DomainParticipant_delete_multitopic (DDS_DomainParticipant dp, DDS_MultiTopic a_multitopic)
DDS_ReturnCode_t	DDS_DomainParticipant_delete_contained_entities (DDS_DomainParticipant dp)
	This operation deletes all the objects created by means of the create operations on DomainParticipant dp.
DDS_ReturnCode_t	DDS_DomainParticipant_set_qos (DDS_DomainParticipant dp, const DDS_DomainParticipantQos *qos)
	Sets the DDS_DomainParticipantQoS values.
DDS_ReturnCode_t	DDS_DomainParticipant_get_qos (DDS_DomainParticipant dp, DDS_DomainParticipantQos *qos)
	Provides access to the DDS_DomainParticipantQoS settings of the DomainParticipant.
DDS_ReturnCode_t	DDS_DomainParticipant_set_listener (DDS_DomainParticipant dp, DDS_DomainParticipantListener *a_listener, DDS_StatusMask mask)
	This operation installs a DDS_DomainParticipantListener on the DomainParticipant.
DDS_ReturnCode_t	DDS_DomainParticipant_set_listener_cd (DDS_DomainParticipant dp, DDS_DomainParticipantListener_cd a_listener, DDS_StatusMask mask, void callback_data)
	This operation installs a DDS_DomainParticipantListener_cd on the DomainParticipant.
DDS_DomainParticipantListener *	DDS_DomainParticipant_get_listener (DDS_DomainParticipant dp)
	This operation returns the currently installed DDS_DomainParticipantListener.
DDS_DomainParticipantListener_cd *	DDS_DomainParticipant_get_listener_cd (DDS_DomainParticipant dp)
	This operation returns the currently installed DDS_DomainParticipantListener_cd.
DDS_ReturnCode_t	DDS_DomainParticipant_ignore_participant (DDS_DomainParticipant dp, const DDS_InstanceHandle_t handle)
	Instructs the DomainParticipant dp to ignore the external DomainParticipant identified by handle.
DDS_ReturnCode_t	DDS_DomainParticipant_ignore_topic (DDS_DomainParticipant dp, const DDS_InstanceHandle_t handle)
	This operation instructs the DomainParticipant dp to ignore a Topic identified by handle.
DDS_ReturnCode_t	DDS_DomainParticipant_ignore_publication (DDS_DomainParticipant dp, const DDS_InstanceHandle_t handle)
	This operation instructs the DomainParticipant dp to ignore a Publication identified by handle.
DDS_ReturnCode_t	DDS_DomainParticipant_ignore_subscription (DDS_DomainParticipant dp, const DDS_InstanceHandle_t handle)
	This operation instructs the DomainParticipant dp to ignore a Subscription identified by handle.
DDS_DomainId_t	DDS_DomainParticipant_get_domain_id (DDS_DomainParticipant dp)
	This operation retrieves the domain_id to which the DomainParticipant belongs.
DDS_ReturnCode_t	DDS_DomainParticipant_assert_liveliness (DDS_DomainParticipant dp)
	This operation manually asserts the liveliness of the DomainParticipant dp.
DDS_ReturnCode_t	DDS_DomainParticipant_set_default_publisher_qos (DDS_DomainParticipant d, DDS_PublisherQos *qos)
	Sets the default DDS_PublisherQos held in the DomainParticipant.
DDS_ReturnCode_t	DDS_DomainParticipant_get_default_publisher_qos (DDS_DomainParticipant d, DDS_PublisherQos *qos)
	Provides access to the default DDS_PublisherQos settings held in the factory.
DDS_ReturnCode_t	DDS_DomainParticipant_set_default_subscriber_qos (DDS_DomainParticipant d, DDS_SubscriberQos *qos)
	Sets the default DDS_SubscriberQos held in the DomainParticipant.
DDS_ReturnCode_t	DDS_DomainParticipant_get_default_subscriber_qos (DDS_DomainParticipant d, DDS_SubscriberQos *qos)
	Provides access to the default DDS_SubscriberQos settings held in the factory.
DDS_ReturnCode_t	DDS_DomainParticipant_set_default_topic_qos (DDS_DomainParticipant d, DDS_TopicQos *qos)
	Sets the default DDS_TopicQos held in the DomainParticipant.
DDS_ReturnCode_t	DDS_DomainParticipant_get_default_topic_qos (DDS_DomainParticipant d, DDS_TopicQos *qos)
	Provides access to the default DDS_TopicQos settings held in the factory.
DDS_ReturnCode_t	DDS_DomainParticipant_get_discovered_participants (DDS_DomainParticipant d, DDS_InstanceHandleSeq *participant_handles)
	This operation returns the list of handles identifying the DDS_DomainParticipant objects that have been discovered.
DDS_ReturnCode_t	DDS_DomainParticipant_get_discovered_participant_data (DDS_DomainParticipant d, DDS_ParticipantBuiltinTopicData *participant_data, const DDS_InstanceHandle_t participant_handle)
	This operation returns data that describes a particular discovered participant identified by participant_handle.
DDS_ReturnCode_t	DDS_DomainParticipant_get_discovered_topics (DDS_DomainParticipant d, DDS_InstanceHandleSeq *topic_handles)
	This operation returns the list of handles identifying the DDS_Topic objects that have been discovered.
DDS_ReturnCode_t	DDS_DomainParticipant_get_discovered_topic_data (DDS_DomainParticipant d, DDS_TopicBuiltinTopicData *topic_data, const DDS_InstanceHandle_t topic_handle)
	This operation returns data that describes a particular discovered topic identified by topic_handle.
unsigned char	DDS_DomainParticipant_contains_entity (DDS_DomainParticipant d, const DDS_InstanceHandle_t a_handle)
	This operation checks whether or not the given handle a_handle represents an object that was created by the DomainParticipant d.
DDS_ReturnCode_t	DDS_DomainParticipant_get_current_time (DDS_DomainParticipant d, DDS_Time_t *current_time)
	This operation returns the current value of the time used by the service.
DDS_ReturnCode_t	DDS_DomainParticipant_register_type (DDS_DomainParticipant dp, DDS_TypeSupport ts, const char *type_name)
	Registers a TypeSupport with the Participant.
int	DDS_DomainParticipant_check_version (DDS_DomainParticipant dp, const char major, const char minor, const char *patch)
	Tests the provided version information against the version of the running CoreDX DDS library.
DDS_ReturnCode_t	DDS_DomainParticipant_do_work (DDS_DomainParticipant dp, DDS_Duration_t *time_slice)
	Transfer control to the DomainParticipant so it can do background processing.
DDS_ReturnCode_t	DDS_DomainParticipant_builtin_wait_for_acknowledgments (DDS_DomainParticipant dp, DDS_Duration_t *max_wait)
	Ensure that local discovery information has been received by all known peers.
void	DDS_DomainParticipant_print_stats (DDS_DomainParticipant dp)
	Prints simple summary debug stats to stdout for each Reader and Writer.
DDS_ReturnCode_t	DDS_DomainParticipant_add_transport (DDS_DomainParticipant dp, struct CoreDX_Transport *transport)
	Adds the provided transport to the DomainParticipant.
DDS_ReturnCode_t	CoreDX_DDS_heap_init (void *heap_ptr, unsigned int size)
	Provide a block of memory for CoreDX DDS to use.

Detailed Description

The DDS_DomainParticipant is used to configure, create and destroy Publisher, Subscriber and Topic objects.

The DomainParticipant is a container for the objects that it creates. The objects operate within the domain identified by the domain_id provided when the DomainParticipant was created. Objects within different domains do not communicate or interfere with each other.

Friends And Related Function Documentation

DDS_ReturnCode_t CoreDX_DDS_heap_init	(	void *	heap_ptr,
		unsigned int	size
	)			`[related]`

Provide a block of memory for CoreDX DDS to use.

On CoreDX DDS builds configured to not use Heap memory allocation routines from the Operating System (common for embedded or Safety Critical environments), this routine is used to assign a block of memory for CoreDX DDS usage. All memory required by CoreDX DDS will be constrained to this block of memory, and no other memory resources will be used.

Note:: It is required that the heap be initialized prior to making any other calls to the CoreDX DDS API.

Return values:

	DDS_RETCODE_OK	on success
	DDS_RETCODE_UNSUPPORTED	if the build is configured to use the Heap from the OS.

DDS_ReturnCode_t DDS_DomainParticipant_add_transport	(	DDS_DomainParticipant	dp,
		struct CoreDX_Transport *	transport
	)			`[related]`

Adds the provided transport to the DomainParticipant.

The transport is registered with the DomainParticipant, and will be used for communication. If no transports are manually added, then the DomainParticipant will automatically add the default UDP transport. The DomainParticipant takes ownership of the provided transport; when the DomainParticipant is deleted, it will release the resources of all added transports.

Note:: Transports can be installed only before a DomainParticipant is enabled.

DDS_ReturnCode_t DDS_DomainParticipant_assert_liveliness ( DDS_DomainParticipant dp ) [related]

This operation manually asserts the liveliness of the DomainParticipant dp.

This operation indicates that the DomainParticipant is still alive. It is effective only if the DomainParticipant contains on ore more DataWriter objects with LIVELINES QoS set to DDS_MANUAL_BY_PARTICIPANT. In this case, the operation will assert the liveliness of those particular DataWriter objects.

Note:: Writing data via the DataWriter write operation automatically asserts the liveliness of the DataWriter and its containing DomainParticipant. Therefore, the use of DDS_DomainParticipant_assert_liveliness() is needed only if the application is not writing data frequently enough to keep the DataWriter considered 'alive'.

int DDS_DomainParticipant_check_version	(	DDS_DomainParticipant	dp,
		const char *	major,
		const char *	minor,
		const char *	patch
	)			`[related]`

Tests the provided version information against the version of the running CoreDX DDS library.

If the provided major and minor numbers match those of the running library, then the routine returns 0. If the provided numbers are larger than those of the running library, then the routine returns a positive number (indicating that the provided version is greater than the library version). Finaly, if the provied version is less than the library version, a negative number is returned. Currently, the 'patch' value is ignored.

unsigned char DDS_DomainParticipant_contains_entity	(	DDS_DomainParticipant	d,
		const DDS_InstanceHandle_t	a_handle
	)			`[related]`

This operation checks whether or not the given handle a_handle represents an object that was created by the DomainParticipant d.

This applies recursively to all objects created by the DomainParticipant.

The routine will return true (non-zero) if the handle is found, zero otherwise.

DDS_ContentFilteredTopic DDS_DomainParticipant_create_contentfilteredtopic	(	DDS_DomainParticipant	dp,
		const char *	name,
		const DDS_Topic	related_topic,
		const char *	filter_expression,
		const DDS_StringSeq *	filter_parameters
	)			`[related]`

This operation creates a ContentFilteredTopic.

The ContentFilteredTopic is associated with another un-filtered topic related_topic. It applies a filter to the data of the related topic. If a data sample passes the filter, it will be made available to a DataReader associated with the ContentFilteredTopic.

The filter_expression is an SQL like condition expression, and filter_parameters provide optional parameters that are referenced by the filter_expression. The syntax of the filter expression is similar to the WHERE clause in SQL. For example "x<4" is a valid filter expression. It would test that data member 'x' is less than value '4'. If the filter expression evaluates to TRUE, then the data sample will be available, otherwise the data sample would be 'filtered' (excluded).

CoreDX DDS supports the 'LIKE' operator (and NOT LIKE) for regular expression string matching. The pattern string in a LIKE clause can contain '' to match zero or more characters, '_' to match a single character, or '[<characters>]' to match a range of characters.

CoreDX DDS also includes support for the 'IN' operator. This provides a very powerful mechanism for testing that a value appears in a set of values. For example "symbol IN ('ge', 'msft', 'ibm')" will select all samples that have a symbol value of 'ge', 'msft', or 'ibm'. This could also be written as a series of equality tests combined with the OR operator; however, the IN operator is much more efficient. A filter that matches on several hundred or even thousands of values can be implemented very efficiently using the 'IN' operator.

The filter_expression can refer to parameters. The syntax for paramters is the percent sign '' followed by a number. The number is the index of the paramter in the filter_paramters sequence. Parameters are counted starting at zero. So, "%0" refers to the first parameter, and "%4" refers to the fifth paramter. Using this syntax, the expression "x<%0" would test the value of 'x' against the first parameter in the sequence.

DDS_MultiTopic DDS_DomainParticipant_create_multitopic	(	DDS_DomainParticipant	dp,
		const char *	name,
		const char *	type_name,
		const char *	subscription_expression,
		const DDS_StringSeq *	expression_parameters
	)			`[related]`

Not Yet Supported:: This operation is not implemented yet.

DDS_Publisher DDS_DomainParticipant_create_publisher	(	DDS_DomainParticipant	dp,
		DDS_PublisherQos *	qos,
		DDS_PublisherListener *	a_listener,
		DDS_StatusMask	mask
	)			`[related]`

This operation creates a DDS_Publisher with the specified DDS_PublisherQoS settings and DDS_PublisherListener.

The value DDS_PUBLISHER_QOS_DEFAULT may be provided for the qos argument. This will indicate that the the default publisher QoS settings held in the DomainParticipant should be used.

This operation may fail and return NULL if the QoS settings are internally inconsistent.

DDS_Subscriber DDS_DomainParticipant_create_subscriber	(	DDS_DomainParticipant	dp,
		DDS_SubscriberQos *	qos,
		DDS_SubscriberListener *	a_listener,
		DDS_StatusMask	mask
	)			`[related]`

This operation creates a DDS_Subscriber with the specified DDS_SubscriberQos and DDS_SubscriberListener.

The value DDS_SUBSCRIBER_QOS_DEFAULT may be provided for the qos argument. This will indicate that the the default subscriber QoS settings held in the DomainParticipant should be used.

This operation may fail and return NULL if the QoS settings are internally inconsistent.

DDS_Topic DDS_DomainParticipant_create_topic	(	DDS_DomainParticipant	dp,
		const char *	topic_name,
		const char *	type_name,
		DDS_TopicQos *	qos,
		DDS_TopicListener *	a_listener,
		DDS_StatusMask	mask
	)			`[related]`

This operation creates a DDS_Topic with the specified DDS_TopicQos settings and DDS_TopicListener.

The value DDS_TOPIC_QOS_DEFAULT may be provided for the qos argument. This will indicate that the the default topic QoS settings held in the DomainParticipant should be used.

The topic is created with a reference to the data type indicated by the type_name argument. The data type must have been registered with the DomainParticipant (by a call to register_type() on the appropriate TypeSupport object) prior to calling create_topic().

This operation may fail and return NULL if the QoS settings are internally inconsistent.

The topic returned from this operation (if not NULL) must be deleted by calling DDS_DomainParticipant_delete_topic().

DDS_ReturnCode_t DDS_DomainParticipant_delete_contained_entities ( DDS_DomainParticipant dp ) [related]

This operation deletes all the objects created by means of the create operations on DomainParticipant dp.

This routine will recursively call the corresponding delete_contained_entities() operation on each of the contained objects (Publishers, Subscribers, Topics, ContentFilteredTopics, and MultiTopics). If successful, this operation will recursively delete all objects contained with this DomainParticipant. After successful execution, the application may delete the DomainParticipant by calling DDS_DomainParticipantFactory_delete_participant().

If any of the objects cannot be deleted, this routine will return DDS_RETCODE_PRECONDITION_NOT_MET.

DDS_ReturnCode_t DDS_DomainParticipant_delete_contentfilteredtopic	(	DDS_DomainParticipant	dp,
		DDS_ContentFilteredTopic	a_contentfilteredtopic
	)			`[related]`

This operation deletes a previously allocated ContentFilteredTopic.

This operation will fail if there are any DDS_DataReader, DDS_DataWriter, DDS_ContentFilteredTopic, or DDS_MultiTopic objects that reference the specified Topic. In this case, the operation will return DDS_RETCODE_PRECONDITION_NOT_MET.

The Topic must be owned by DomainPartipant dp; otherwise DDS_RETCODE_PRECONDITION_NOT_MET will be returned.

DDS_ReturnCode_t DDS_DomainParticipant_delete_multitopic	(	DDS_DomainParticipant	dp,
		DDS_MultiTopic	a_multitopic
	)			`[related]`

Not Yet Supported:: This operation is not implemented yet.

DDS_ReturnCode_t DDS_DomainParticipant_delete_publisher	(	DDS_DomainParticipant	dp,
		DDS_Publisher	p
	)			`[related]`

This operation deletes an existing DDS_Publisher.

A Publisher cannot be deleted if it contains any DDS_DataWriter objects. In this case, delete_publisher will return DDS_RETCODE_PRECONDITION_NOT_MET.

If the DomainParticipant dp does not contain the provided Publisher p, the operation will return DDS_RETCODE_PRECONDITION_NOT_MET.

DDS_ReturnCode_t DDS_DomainParticipant_delete_subscriber	(	DDS_DomainParticipant	dp,
		DDS_Subscriber	s
	)			`[related]`

This operation deletes an existing DDS_Subscriber.

A Subscriber cannot be deleted if it contains any DDS_DataReader objects. In this case, delete_subscriber will return DDS_RETCODE_PRECONDITION_NOT_MET.

If the DomainParticipant dp does not contain the provided Subscriber s, the operation will return DDS_RETCODE_PRECONDITION_NOT_MET.

DDS_ReturnCode_t DDS_DomainParticipant_delete_topic	(	DDS_DomainParticipant	dp,
		DDS_Topic	a_topic
	)			`[related]`

This operation deletes a DDS_Topic.

This operation will fail if there are any DDS_DataReader, DDS_DataWriter, DDS_ContentFilteredTopic, or DDS_MultiTopic objects that reference the specified Topic. In this case, the operation will return DDS_RETCODE_PRECONDITION_NOT_MET.

The Topic must be owned by DomainPartipant dp; otherwise DDS_RETCODE_PRECONDITION_NOT_MET will be returned.

DDS_ReturnCode_t DDS_DomainParticipant_do_work	(	DDS_DomainParticipant	dp,
		DDS_Duration_t *	time_slice
	)			`[related]`

Transfer control to the DomainParticipant so it can do background processing.

This function is to be called only if the DomainParticipant is configured to use NO threads via the thread_model QoS policy. The participant will continue to execute background processing until at least 'time_slice' time passes. This routine will attempt to use no more than 'time_slice' time, but this is not a guarantee.

Note:: If the DomainParticipant has threads (default case), then the Participant takes care of scheduling background work on its own, and this routine is not necessary and should not be called.

DDS_ReturnCode_t DDS_DomainParticipant_enable ( DDS_DomainParticipant dp ) [related]

Enables the DomainParticipant.

A DomainParticipant is created either enabled or not based on the DDS_DomainParticipantFactoryQoS setting entity_factory. When a DomainPartcipant is not enabled, only the following sub-set of all DomainParticipant operations are legal:

operations to get and set QoS policies,
factory operations (create, delete),
get_statuscondition(),
get_status_changes(),
lookup operations

Any other DomainParticipant operation will return the DDS_NOT_ENABLED error. DDS_DomainParticipant_enable() may be called on an already enabled DomainParticipant [it will have no effect].

DDS_Topic DDS_DomainParticipant_find_topic	(	DDS_DomainParticipant	dp,
		const char *	topic_name,
		DDS_Duration_t *	timeout
	)			`[related]`

This operation returns a DDS_Topic identified by the provided topic_name.

If a topic with name topic_name is known to exist, the function returns this matching topic immediately. Otherwise, the operation will block for up to the timeout duration. If a topic with name topic_name is discovered or otherwise created, the operation will cease to wait, and will return the matching topic.

If a matching topic is not known by the time the timout has expired, the operation will return NULL.

Like DDS_DomainParticipant_create_topic(), the topic returned from this operation (if not NULL) must be deleted by calling DDS_DomainParticipant_delete_topic().

DDS_Subscriber DDS_DomainParticipant_get_builtin_subscriber ( struct _DomainParticipant * d ) [related]

Returns the built-in DDS_Subscriber.

Each DomainParticipant contains several built-in Topic objects as well as corresponding DataReader objects to access them. These built-in DataReader objects belong to the single built-in Subscriber that is accessed through this operation.

The built-in Topics are used to communicate information about other DDS_DomainParticipant, DDS_Topic, DDS_DataReader, and DDS_DataWriter objects.

An application should not explicitly delete the Subscriber returned by this operation - it is managed internally.

DDS_ReturnCode_t DDS_DomainParticipant_get_default_publisher_qos	(	DDS_DomainParticipant	d,
		DDS_PublisherQos *	qos
	)			`[related]`

Provides access to the default DDS_PublisherQos settings held in the factory.

The provided qos argument is populated with the default qos settings.

DDS_ReturnCode_t DDS_DomainParticipant_get_default_subscriber_qos	(	DDS_DomainParticipant	d,
		DDS_SubscriberQos *	qos
	)			`[related]`

Provides access to the default DDS_SubscriberQos settings held in the factory.

The provided qos argument is populated with the default qos settings.

DDS_ReturnCode_t DDS_DomainParticipant_get_default_topic_qos	(	DDS_DomainParticipant	d,
		DDS_TopicQos *	qos
	)			`[related]`

Provides access to the default DDS_TopicQos settings held in the factory.

The provided qos argument is populated with the default qos settings.

DDS_ReturnCode_t DDS_DomainParticipant_get_discovered_participant_data	(	DDS_DomainParticipant	d,
		DDS_ParticipantBuiltinTopicData *	participant_data,
		const DDS_InstanceHandle_t	participant_handle
	)			`[related]`

This operation returns data that describes a particular discovered participant identified by participant_handle.

An appropriate handle can be obtained through a call to DDS_DomainParticipant_get_discovered_participants().

If participant_handle does not identify a known DomainParticipant, this routine will return DDS_RETCODE_PRECONDITION_NOT_MET.

DDS_ReturnCode_t DDS_DomainParticipant_get_discovered_participants	(	DDS_DomainParticipant	d,
		DDS_InstanceHandleSeq *	participant_handles
	)			`[related]`

This operation returns the list of handles identifying the DDS_DomainParticipant objects that have been discovered.

The returned list will include only participants which are in the same domain as participant d, and which are not explicitly ignored as a result of a call to DDS_DomainParticipant_ignore_participant().

This routine allocates memory to populate the participant_handles sequence. The application is responsible for freeing this memory.

DDS_ReturnCode_t DDS_DomainParticipant_get_discovered_topic_data	(	DDS_DomainParticipant	d,
		DDS_TopicBuiltinTopicData *	topic_data,
		const DDS_InstanceHandle_t	topic_handle
	)			`[related]`

This operation returns data that describes a particular discovered topic identified by topic_handle.

An appropriate handle can be obtained through a call to DDS_DomainParticipant_get_discovered_topics().

If topic_handle does not identify a known Topic, this routine will return DDS_RETCODE_PRECONDITION_NOT_MET.

DDS_ReturnCode_t DDS_DomainParticipant_get_discovered_topics	(	DDS_DomainParticipant	d,
		DDS_InstanceHandleSeq *	topic_handles
	)			`[related]`

This operation returns the list of handles identifying the DDS_Topic objects that have been discovered.

The returned list will include only topics which are in the same domain as participant d, and which are not explicitly ignored as a result of a call to DDS_DomainParticipant_ignore_topic().

This routine allocates memory to populate the topic_handles sequence. The application is responsible for freeing this memory.

DDS_DomainParticipantListener * DDS_DomainParticipant_get_listener ( DDS_DomainParticipant dp ) [related]

This operation returns the currently installed DDS_DomainParticipantListener.

Note:: Because the infrastructure makes a copy of the listener provided in DDS_DomainParticipant_set_listener(), the returned structure pointer will not match the pointer originally provided. However, the function pointers within the structure will match. Also, the application should not free the data referenced by the returned pointer.

DDS_DomainParticipantListener_cd * DDS_DomainParticipant_get_listener_cd ( DDS_DomainParticipant dp ) [related]

This operation returns the currently installed DDS_DomainParticipantListener_cd.

Note:: Because the infrastructure does not make a copy of the listener_cd provided in DDS_DomainParticipant_set_listener_cd(), the returned structure pointer will match the pointer originally provided. The application should not free the data referenced by the returned pointer.

DDS_StatusMask DDS_DomainParticipant_get_status_changes ( DDS_DomainParticipant dp ) [related]

This returns the list of triggered communication statuses in the DomainParticipant.

If the DomainParticipant is not enabled, all statuses will be untriggered. The list returned by get_status_changes may be empty. The list of statuses returned by get_status_changes operation contains statuses that are triggered on the DomainParticipant itself and does not include statuses from contained objects.

DDS_StatusCondition DDS_DomainParticipant_get_statuscondition ( DDS_DomainParticipant dp ) [related]

This operation allows access to the DDS_StatusCondition associated with the DomainParticipant.

The returned condition can be added to a DDS_WaitSet.

DDS_ReturnCode_t DDS_DomainParticipant_ignore_participant	(	DDS_DomainParticipant	dp,
		const DDS_InstanceHandle_t	handle
	)			`[related]`

Instructs the DomainParticipant dp to ignore the external DomainParticipant identified by handle.

This will cause the infrastructure to behave as if the external participant handle did not exist. The handle can be discovered by accessing the built-in topic DCPSParticipant via the appropriate built-in DataReader.

There is no mechanism to reverse this operation.

DDS_ReturnCode_t DDS_DomainParticipant_ignore_publication	(	DDS_DomainParticipant	dp,
		const DDS_InstanceHandle_t	handle
	)			`[related]`

This operation instructs the DomainParticipant dp to ignore a Publication identified by handle.

The handle can be discovered by accessing the built-in topic DCPSPublication via the appropriate built-in DataReader.

There is no mechanism to reverse this operation.

Not Yet Supported:: This operation is not implemented yet.

DDS_ReturnCode_t DDS_DomainParticipant_ignore_subscription	(	DDS_DomainParticipant	dp,
		const DDS_InstanceHandle_t	handle
	)			`[related]`

This operation instructs the DomainParticipant dp to ignore a Subscription identified by handle.

The handle can be discovered by accessing the built-in topic DCPSSubscription via the appropriate built-in DataReader.

There is no mechanism to reverse this operation.

Not Yet Supported:: This operation is not implemented yet.

DDS_ReturnCode_t DDS_DomainParticipant_ignore_topic	(	DDS_DomainParticipant	dp,
		const DDS_InstanceHandle_t	handle
	)			`[related]`

This operation instructs the DomainParticipant dp to ignore a Topic identified by handle.

This can be used to save resources if a participant will never participate on certain Topics. The handle can be discovered by accessing the built-in topic DCPSTopic via the appropriate built-in DataReader.

There is no mechanism to reverse this operation.

Not Yet Supported:: This operation is not implemented yet.

DDS_TopicDescription DDS_DomainParticipant_lookup_topicdescription	(	DDS_DomainParticipant	dp,
		const char *	name
	)			`[related]`

This operation returns an existing, locally-created DDS_TopicDescription, named name.

If a TopicDescription named name does not exist, then this routine will return NULL.

DDS_ReturnCode_t DDS_DomainParticipant_register_type	(	DDS_DomainParticipant	dp,
		DDS_TypeSupport	ts,
		const char *	type_name
	)			`[related]`

Registers a TypeSupport with the Participant.

Associates a TypeSupport object with the provided 'type_name'. This TypeSupport will be used to handle data that has a matching type_name. If a TypeSupport has already been registered for the provied type_name, then an error is returned and the previously registered TypeSupport is maintained.

DDS_ReturnCode_t DDS_DomainParticipant_set_default_publisher_qos	(	DDS_DomainParticipant	d,
		DDS_PublisherQos *	qos
	)			`[related]`

Sets the default DDS_PublisherQos held in the DomainParticipant.

This default qos will be used during subsequent calls to DDS_DomainParticipant_create_publisher() if the special DDS_PUBLISHER_QOS_DEFAULT value is provided for qos.
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 DomainParticipant.

DDS_ReturnCode_t DDS_DomainParticipant_set_default_subscriber_qos	(	DDS_DomainParticipant	d,
		DDS_SubscriberQos *	qos
	)			`[related]`

Sets the default DDS_SubscriberQos held in the DomainParticipant.

This default qos will be used during subsequent calls to DDS_DomainParticipant_create_subscriber() if the special DDS_SUBSCRIBER_QOS_DEFAULT value is provided for qos.
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 DomainParticipant.

DDS_ReturnCode_t DDS_DomainParticipant_set_default_topic_qos	(	DDS_DomainParticipant	d,
		DDS_TopicQos *	qos
	)			`[related]`

Sets the default DDS_TopicQos held in the DomainParticipant.

This default qos will be used during subsequent calls to DDS_DomainParticipant_create_topic() [and related] if the special DDS_TOPIC_QOS_DEFAULT value is provided for qos.
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 DomainParticipant.

DDS_ReturnCode_t DDS_DomainParticipant_set_listener	(	DDS_DomainParticipant	dp,
		DDS_DomainParticipantListener *	a_listener,
		DDS_StatusMask	mask
	)			`[related]`

This operation installs a DDS_DomainParticipantListener on the DomainParticipant.

Only one listener may be attached to a DomainParticipant at a time. A call to set_listener() will replace any current listener with a_listener.

a_listener can be NULL, which indicates a listener that does nothing.

The infrastructure will make an internal copy of the listener structure so that it need not be persisted by the application.

DDS_ReturnCode_t DDS_DomainParticipant_set_listener_cd	(	DDS_DomainParticipant	dp,
		DDS_DomainParticipantListener_cd *	a_listener,
		DDS_StatusMask	mask,
		void *	callback_data
	)			`[related]`

This operation installs a DDS_DomainParticipantListener_cd on the DomainParticipant.

Only one listener may be attached to a DomainParticipant at a time. A call to set_listener_cd() will replace any current listener with a_listener.

a_listener can be NULL, which indicates a listener that does nothing.

The infrastructure does not make an internal copy of the listener structure which means that it must persisted by the application.

DDS_ReturnCode_t DDS_DomainParticipant_set_qos	(	DDS_DomainParticipant	dp,
		const DDS_DomainParticipantQos *	qos
	)			`[related]`

Sets the DDS_DomainParticipantQoS values.

These QoS values affect the behavior of the DomainParticipant.

CoreDX DDSC Reference Manual

DDS_DomainParticipant Struct Reference [DDS Entities]

Related Functions

Detailed Description

Friends And Related Function Documentation

CoreDX DDS
C Reference Manual

DDS_DomainParticipant Struct Reference
[DDS Entities]