RTI Connext Modern C++ API  Version 6.1.0
rti::core::status::ReliableReaderActivityChangedStatus Class Reference

<<extension>> Information about the status dds::core::status::StatusMask::reliable_reader_activity_changed() More...

#include <Status.hpp>

Inherits rti::core::NativeValueType< T, NATIVE_T, ADAPTER >.

Public Member Functions

EventCount32 active_count () const
 The current number of reliable readers currently matched with this reliable writer. More...
 
EventCount32 inactive_count () const
 The number of reliable readers that have been dropped by this reliable writer because they failed to send acknowledgements in a timely fashion. More...
 
dds::core::InstanceHandle last_instance_handle () const
 The instance handle of the last reliable remote reader to be determined inactive. More...
 

Detailed Description

<<extension>> Information about the status dds::core::status::StatusMask::reliable_reader_activity_changed()

Entity:
dds::pub::DataWriter
Listener:
dds::pub::DataWriterListener

This status is the reciprocal status to the dds::core::status::LivelinessChangedStatus on the reader. It is different than the dds::core::status::LivelinessLostStatus on the writer in that the latter informs the writer about its own liveliness; this status informs the writer about the "liveliness" (activity) of its matched readers.

All counts in this status will remain at zero for best effort writers.

Member Function Documentation

◆ active_count()

EventCount32 rti::core::status::ReliableReaderActivityChangedStatus::active_count ( ) const
inline

The current number of reliable readers currently matched with this reliable writer.

◆ inactive_count()

EventCount32 rti::core::status::ReliableReaderActivityChangedStatus::inactive_count ( ) const
inline

The number of reliable readers that have been dropped by this reliable writer because they failed to send acknowledgements in a timely fashion.

A reader is considered to be inactive after is has been sent heartbeats rti::core::RtpsReliableWriterProtocol::max_heartbeat_retries times, each heartbeat having been separated from the previous by the current heartbeat period.

◆ last_instance_handle()

dds::core::InstanceHandle rti::core::status::ReliableReaderActivityChangedStatus::last_instance_handle ( ) const
inline

The instance handle of the last reliable remote reader to be determined inactive.