RTI Connext C++ API  Version 5.1.0
DATA_WRITER_RESOURCE_LIMITS

<<eXtension>> Various settings that configure how a DDSDataWriter allocates and uses physical memory for internal resources. More...

Classes

struct  DDS_DataWriterResourceLimitsQosPolicy
 Various settings that configure how a DDSDataWriter allocates and uses physical memory for internal resources. More...
 

Enumerations

enum  DDS_DataWriterResourceLimitsInstanceReplacementKind {
  DDS_UNREGISTERED_INSTANCE_REPLACEMENT,
  DDS_ALIVE_INSTANCE_REPLACEMENT,
  DDS_DISPOSED_INSTANCE_REPLACEMENT,
  DDS_ALIVE_THEN_DISPOSED_INSTANCE_REPLACEMENT,
  DDS_DISPOSED_THEN_ALIVE_INSTANCE_REPLACEMENT,
  DDS_ALIVE_OR_DISPOSED_INSTANCE_REPLACEMENT
}
 Sets the kinds of instances that can be replaced when instance resource limits are reached. More...
 

Variables

const char *const DDS_DATAWRITERRESOURCELIMITS_QOS_POLICY_NAME
 Stringified human-readable name for DDS_DataWriterResourceLimitsQosPolicy.
 

Detailed Description

<<eXtension>> Various settings that configure how a DDSDataWriter allocates and uses physical memory for internal resources.

Enumeration Type Documentation

Sets the kinds of instances that can be replaced when instance resource limits are reached.

When DDS_ResourceLimitsQosPolicy::max_instances is reached, a DDSDataWriter will try to make room for a new instance by attempting to reclaim an existing instance based on the instance replacement kind specified by DDS_DataWriterResourceLimitsQosPolicy::instance_replacement.

Only instances whose states match the specified kinds are eligible to be replaced. In addition, an instance must have had all of its samples fully acknowledged for it to be considered replaceable.

For all kinds, a DDSDataWriter will replace the oldest instance satisfying that kind. For example, when the kind is DDS_UNREGISTERED_INSTANCE_REPLACEMENT, a DDSDataWriter will remove the oldest fully acknowledged unregistered instance, if such an instance exists.

If no replaceable instance exists, the invoked function will either return with an appropriate out-of-resources return code, or in the case of a write, it may first block to wait for an instance to be acknowledged. Otherwise, the DDSDataWriter will replace the old instance with the new instance, and invoke, if available, the ::DDS_DataWriterListener_InstanceReplacedCallback to notify the user about an instance being replaced.

A DDSDataWriter checks for replaceable instances in the following order, stopping once a replaceable instance is found:

If DDS_DataWriterResourceLimitsQosPolicy::replace_empty_instances is DDS_BOOLEAN_TRUE, a DDSDataWriter first tries replacing instances that have no samples. These empty instances can be unregistered, disposed, or alive. Next, a DDSDataWriter tries replacing unregistered instances. Since an unregistered instance indicates that the DDSDataWriter is done modifying it, unregistered instances are replaced before instances of any other state (alive, disposed). This is the same as the DDS_UNREGISTERED_INSTANCE_REPLACEMENT kind. Then, a DDSDataWriter tries replacing what is specified by DDS_DataWriterResourceLimitsQosPolicy::instance_replacement. With unregistered instances already checked, this leaves alive and disposed instances. When both alive and disposed instances may be replaced, the kind specifies whether the particular order matters (e.g. DISPOSED_THEN_ALIVE, ALIVE_THEN_DISPOSED) or not (ALIVE_OR_DISPOSED).

QoS:
DDS_DataWriterResourceLimitsQosPolicy
Enumerator:
DDS_UNREGISTERED_INSTANCE_REPLACEMENT 

Allows a DDSDataWriter to reclaim unregistered acknowledged instances.

By default all instance replacement kinds first attempt to reclaim an unregistered acknowledged instance. Used in DDS_DataWriterResourceLimitsQosPolicy::instance_replacement [default]

DDS_ALIVE_INSTANCE_REPLACEMENT 

Allows a DDSDataWriter to reclaim alive acknowledged instances.

When an unregistered acknowledged instance is not available to reclaim, this kind allows a DDSDataWriter to reclaim an alive acknowledged instance, where an alive instance is a registered, non-disposed instance. The least recently registered or written alive instance will be reclaimed.

DDS_DISPOSED_INSTANCE_REPLACEMENT 

Allows a DDSDataWriter to reclaim disposed acknowledged instances.

When an unregistered acknowledged instance is not available to reclaim, this kind allows a DDSDataWriter to reclaim a disposed acknowledged instance. The least recently disposed instance will be reclaimed.

DDS_ALIVE_THEN_DISPOSED_INSTANCE_REPLACEMENT 

Allows a DDSDataWriter first to reclaim an alive acknowledged instance, and then if necessary a disposed acknowledged instance.

When an unregistered acknowledged instance is not available to reclaim, this kind allows a DDSDataWriter first try reclaiming an alive acknowledged instance. If no instance is reclaimable, then it trys reclaiming a disposed acknowledged instance. The least recently used (i.e. registered, written, or disposed) instance will be reclaimed.

DDS_DISPOSED_THEN_ALIVE_INSTANCE_REPLACEMENT 

Allows a DDSDataWriter first to reclaim a disposed acknowledged instance, and then if necessary an alive acknowledged instance.

When an unregistered acknowledged instance is not available to reclaim, this kind allows a DDSDataWriter first try reclaiming a disposed acknowledged instance. If no instance is reclaimable, then it trys reclaiming an alive acknowledged instance. The least recently used (i.e. disposed, registered, or written) instance will be reclaimed.

DDS_ALIVE_OR_DISPOSED_INSTANCE_REPLACEMENT 

Allows a DDSDataWriter to reclaim a either an alive acknowledged instance or a disposed acknowledged instance.

When an unregistered acknowledged instance is not available to reclaim, this kind allows a DDSDataWriter to reclaim either an alive acknowledged instance or a disposed acknowledged instance. If both instance kinds are available to reclaim, the DDSDataWriter will reclaim the least recently used (i.e. disposed, registered, or written) instance.

Variable Documentation

const char* const DDS_DATAWRITERRESOURCELIMITS_QOS_POLICY_NAME

Stringified human-readable name for DDS_DataWriterResourceLimitsQosPolicy.


RTI Connext C++ API Version 5.1.0 Copyright © Mon Feb 3 2014 Real-Time Innovations, Inc