RTI Connext C API  Version 5.0.0
DDS_ReliableReaderActivityChangedStatus Struct Reference

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

Data Fields

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

Detailed Description

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

Entity:
DDS_DataWriter
Listener:
DDS_DataWriterListener

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.

Field Documentation

DDS_Long DDS_ReliableReaderActivityChangedStatus::active_count

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

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.

DDS_Long DDS_ReliableReaderActivityChangedStatus::active_count_change

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

DDS_Long DDS_ReliableReaderActivityChangedStatus::inactive_count_change

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

DDS_InstanceHandle_t DDS_ReliableReaderActivityChangedStatus::last_instance_handle

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


RTI Connext C API Version 5.0.0 Copyright © Thu Aug 30 2012 Real-Time Innovations, Inc