RTI Connext Micro C API Version 4.2.0
Loading...
Searching...
No Matches
DDS_PublicationMatchedStatus Struct Reference

<<cert>> DDS_PUBLICATION_MATCHED_STATUS More...

#include <dds_c_publication.h>

Data Fields

DDS_Long total_count
 The total cumulative number of times the concerned DDS_DataWriter discovered a "match" with a DDS_DataReader.
 
DDS_Long total_count_change
 The incremental changes in total_count since the last time the listener was called or the status was read.
 
DDS_Long current_count
 The current number of readers with which the DDS_DataWriter is matched.
 
DDS_Long current_count_change
 The change in current_count since the last time the listener was called or the status was read.
 
DDS_InstanceHandle_t last_subscription_handle
 A handle to the last DDS_DataReader that caused the the DDS_DataWriter's status to change.
 

Detailed Description

<<cert>> DDS_PUBLICATION_MATCHED_STATUS

A "match" happens when the DDS_DataWriter finds a DDS_DataReader for the same DDS_Topic and common partition with a requested QoS that is compatible with that offered by the DDS_DataWriter.

This status is also changed (and the listener, if any, called) when a match is ended. A local DDS_DataWriter will become "unmatched" from a remote DDS_DataReader when that DDS_DataReader goes away for any reason.

Field Documentation

◆ total_count

DDS_Long DDS_PublicationMatchedStatus::total_count

The total cumulative number of times the concerned DDS_DataWriter discovered a "match" with a DDS_DataReader.

This number increases whenever a new match is discovered. It does not change when an existing match goes away.

◆ total_count_change

DDS_Long DDS_PublicationMatchedStatus::total_count_change

The incremental changes in total_count since the last time the listener was called or the status was read.

◆ current_count

DDS_Long DDS_PublicationMatchedStatus::current_count

The current number of readers with which the DDS_DataWriter is matched.

This number increases when a new match is discovered and decreases when an existing match goes away.

◆ current_count_change

DDS_Long DDS_PublicationMatchedStatus::current_count_change

The change in current_count since the last time the listener was called or the status was read.

◆ last_subscription_handle

DDS_InstanceHandle_t DDS_PublicationMatchedStatus::last_subscription_handle

A handle to the last DDS_DataReader that caused the the DDS_DataWriter's status to change.