RTI Connext DDS Micro C API  Version 3.0.3
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups
DDS_ReliableReaderActivityChangedStatus Struct Reference

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

#include <dds_c_publication.h>

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>> <<cert>> 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 DDS Micro C API Version 3.0.3 Copyright © Wed Jun 24 2020 Real-Time Innovations, Inc