RTI Connext .Net APIs  Version 5.0.0
DDS::ViewStateKind Struct Reference

Indicates whether or not an instance is new. More...

#include <managed_subscription.h>

Properties

static ViewStateKind NEW_VIEW_STATE [get]
 New instance. This latest generation of the instance has not previously been accessed.
 
static ViewStateKind NOT_NEW_VIEW_STATE [get]
 Not a new instance. This latest generation of the instance has previously been accessed.
 
static ViewStateKind ANY_VIEW_STATE [get]
 Any view state DDS::ViewStateKind::NEW_VIEW_STATE | DDS::ViewStateKind::NOT_NEW_VIEW_STATE.
 

Detailed Description

Indicates whether or not an instance is new.

For each instance (identified by the key), the middleware internally maintains a view state relative to each DDS::DataReader. The view state can be either:

The view_state available in the DDS::SampleInfo is a snapshot of the view state of the instance relative to the DDS::DataReader used to access the samples at the time the collection was obtained (i.e. at the time read or take was called). The view_state is therefore the same for all samples in the returned collection that refer to the same instance.

Once an instance has been detected as not having any "live" writers and all the samples associated with the instance are "taken" from the DDS::DataReader, the middleware can reclaim all local resources regarding the instance. Future samples will be treated as "never seen."

Property Documentation

ViewStateKind DDS::ViewStateKind::NEW_VIEW_STATE
staticget

New instance. This latest generation of the instance has not previously been accessed.

ViewStateKind DDS::ViewStateKind::NOT_NEW_VIEW_STATE
staticget

Not a new instance. This latest generation of the instance has previously been accessed.


RTI Connext .Net APIs Version 5.0.0 Copyright © Thu Aug 30 2012 Real-Time Innovations, Inc