DDS::SystemResourceLimitsQosPolicy Struct Reference

<<extension>> Configures DDS::DomainParticipant-independent resources used by RTI Connext. Mainly used to change the maximum number of DDS::DomainParticipant entities that can be created within a single process (address space). More...

#include <managed_infrastructure.h>

Static Public Member Functions
static System::String ^	get_systemresourcelimits_qos_policy_name ()
	Stringified human-readable name for DDS::SystemResourceLimitsQosPolicy. More...

Public Attributes
System::Int32	max_objects_per_thread
	The maximum number of objects that can be stored per thread for a DDS::DomainParticipantFactory. More...

Detailed Description

<<extension>> Configures DDS::DomainParticipant-independent resources used by RTI Connext. Mainly used to change the maximum number of DDS::DomainParticipant entities that can be created within a single process (address space).

Entity:

DDS::DomainParticipantFactory

Properties:

RxO = N/A
Changeable = NO

Usage

Within a single process (or address space for some supported real-time operating systems), applications may create and use multiple DDS::DomainParticipant entities. This QoS policy sets a parameter that places an effective upper bound on the maximum number of DDS::DomainParticipant entities that can be created in a single process/address space.

Member Data Documentation

max_objects_per_thread

System::Int32 DDS::SystemResourceLimitsQosPolicy::max_objects_per_thread

The maximum number of objects that can be stored per thread for a DDS::DomainParticipantFactory.

Before increasing this value to allow you to create more participants, carefully consider the application design that requires you to create so many participants. Remember: a DDS::DomainParticipant is a heavy-weight object. It spawns several threads and maintains its own discovery database (see DISCOVERY). Creating more participants than RTI Connext strictly requires – one per domain per process/address space – can adversely affect the performance and resource utilization of your application.

[default] 2048; this value allows you to create about 15 DDS::DomainParticipant entities, although the number of entities could be fewer depending on your use case.

[range] [1, 1 billion]