RTI Connext Traditional C++ API  Version 6.1.2
DDS_ReliableReaderActivityChangedStatus Struct Reference

<<extension>> Describes the activity (i.e. are acknowledgements forthcoming) of reliable readers matched to a reliable writer. More...

Public Attributes

DDS_Long active_count
 The current number of reliable readers currently matched with this reliable writer. More...
 
DDS_Long inactive_count
 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_Long active_count_change
 The most recent change in the number of active remote reliable readers. More...
 
DDS_Long inactive_count_change
 The most recent change in the number of inactive remote reliable readers. More...
 
DDS_InstanceHandle_t last_instance_handle
 The instance handle of the last reliable remote reader to be determined inactive. More...
 

Detailed Description

<<extension>> Describes the activity (i.e. are acknowledgements forthcoming) of reliable readers matched to a reliable writer.

Entity:
DDSDataWriter
Listener:
DDSDataWriterListener

This status is the reciprocal status to the DDS_LivelinessChangedStatus on the reader. It is different than the DDS_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 Data Documentation

◆ active_count

DDS_Long DDS_ReliableReaderActivityChangedStatus::active_count

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

◆ inactive_count

DDS_Long DDS_ReliableReaderActivityChangedStatus::inactive_count

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 DDS_RtpsReliableWriterProtocol_t::max_heartbeat_retries times, each heartbeat having been separated from the previous by the current heartbeat period.

◆ active_count_change

DDS_Long DDS_ReliableReaderActivityChangedStatus::active_count_change

The most recent change in the number of active remote reliable readers.

◆ inactive_count_change

DDS_Long DDS_ReliableReaderActivityChangedStatus::inactive_count_change

The most recent change in the number of inactive remote reliable readers.

◆ last_instance_handle

DDS_InstanceHandle_t DDS_ReliableReaderActivityChangedStatus::last_instance_handle

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