RTI Connext .Net APIs  Version 5.3.1

Specifies the behavior of RTI Connext in the case where the value of an instance changes (one or more times) before it can be successfully communicated to one or more existing subscribers. More...

Classes

struct  DDS::HistoryQosPolicy
 Specifies the behavior of RTI Connext in the case where the value of a sample changes (one or more times) before it can be successfully communicated to one or more existing subscribers. More...
 

Enumerations

enum  DDS::HistoryQosPolicyKind : UINT32 {
  DDS::HistoryQosPolicyKind::KEEP_LAST_HISTORY_QOS,
  DDS::HistoryQosPolicyKind::KEEP_ALL_HISTORY_QOS
}
 Kinds of history. More...
 
enum  DDS::RefilterQosPolicyKind : UINT32 {
  DDS::RefilterQosPolicyKind::NONE_REFILTER_QOS,
  DDS::RefilterQosPolicyKind::ALL_REFILTER_QOS,
  DDS::RefilterQosPolicyKind::ON_DEMAND_REFILTER_QOS
}
 <<extension>> Kinds of Refiltering More...
 

Functions

static System::String ^ DDS::HistoryQosPolicy::get_history_qos_policy_name ()
 Stringified human-readable name for DDS::HistoryQosPolicy. More...
 

Detailed Description

Specifies the behavior of RTI Connext in the case where the value of an instance changes (one or more times) before it can be successfully communicated to one or more existing subscribers.

Enumeration Type Documentation

◆ HistoryQosPolicyKind

enum DDS::HistoryQosPolicyKind : UINT32
strong

Kinds of history.

QoS:
DDS::HistoryQosPolicy
Enumerator
KEEP_LAST_HISTORY_QOS 

[default] Keep the last depth samples.

On the publishing side, RTI Connext will only attempt to keep the most recent depth samples of each instance of data (identified by its key) managed by the DDS::DataWriter. Invalid samples represeting a disposal or unregistration of an instance do not count towards the history depth.

On the subscribing side, the DDS::DataReader will only attempt to keep the most recent depth samples received for each instance (identified by its key) until the application takes them via the DDS::DataReader 's take() operation.
Invalid samples represeting a dispoasal or unregistration of an instance do count towards the history depth and may therefore replace a value of the instance currently being stored in the reader queue.

KEEP_ALL_HISTORY_QOS 

Keep all the samples.

On the publishing side, RTI Connext will attempt to keep all samples (representing each value written) of each instance of data (identified by its key) managed by the DDS::DataWriter until they can be delivered to all subscribers.

On the subscribing side, RTI Connext will attempt to keep all samples of each instance of data (identified by its key) managed by the DDS::DataReader. These samples are kept until the application takes them from RTI Connext via the take() operation.

◆ RefilterQosPolicyKind

enum DDS::RefilterQosPolicyKind : UINT32
strong

<<extension>> Kinds of Refiltering

QoS:
DDS::HistoryQosPolicy
Enumerator
NONE_REFILTER_QOS 

[default] Do not filter existing samples for a new reader

On the publishing side, when a new reader matches a writer, the writer can be configured to filter previously written samples stored in the writer queue for the new reader. This option configures the writer to not filter any existing samples for the reader and the reader will do the filtering.

ALL_REFILTER_QOS 

Filter all existing samples for a new reader.

On the publishing side, when a new reader matches a writer, the writer can be configured to filter previously written samples stored in the writer queue. This option configures the writer to filter all existing samples for the reader when a new reader is matched to the writer.

ON_DEMAND_REFILTER_QOS 

Filter existing samples only when they are requested by the reader.

On the publishing side, when a new reader matches a writer, the writer can be configured to filter previously written samples stored in the writer queue. This option configures the writer to filter only existing samples that are requested by the reader.

Function Documentation

◆ get_history_qos_policy_name()

static System::String ^ DDS::HistoryQosPolicy::get_history_qos_policy_name ( )
inlinestatic

Stringified human-readable name for DDS::HistoryQosPolicy.


RTI Connext .Net APIs Version 5.3.1 Copyright © Mon Feb 19 2018 Real-Time Innovations, Inc