DDS_DataReaderListener Struct Reference

<<interface>> <<cert>> DDS_Listener for reader status. More...

#include <dds_c_subscription.h>

Data Fields
struct DDS_Listener	as_listener
	<<cert>> The superclass instance of this DDS_DataReaderListener.
DDS_DataReaderListener_RequestedDeadlineMissedCallback	on_requested_deadline_missed
	<<cert>> Handles the DDS_REQUESTED_DEADLINE_MISSED_STATUS communication status.
DDS_DataReaderListener_RequestedIncompatibleQosCallback	on_requested_incompatible_qos
	<<cert>> Handles the DDS_REQUESTED_INCOMPATIBLE_QOS_STATUS communication status.
DDS_DataReaderListener_SampleRejectedCallback	on_sample_rejected
	<<cert>> Handles the DDS_SAMPLE_REJECTED_STATUS communication status.
DDS_DataReaderListener_LivelinessChangedCallback	on_liveliness_changed
	<<cert>> Handles the DDS_LIVELINESS_CHANGED_STATUS communication status.
DDS_DataReaderListener_DataAvailableCallback	on_data_available
	<<cert>> Handle the DDS_DATA_AVAILABLE_STATUS communication status.
DDS_DataReaderListener_SubscriptionMatchedCallback	on_subscription_matched
	<<cert>> Handles the DDS_SUBSCRIPTION_MATCHED_STATUS communication status.
DDS_DataReaderListener_SampleLostCallback	on_sample_lost
	<<cert>> Handles the DDS_SAMPLE_LOST_STATUS communication status.
DDS_DataReaderListener_BeforeSampleDeserializeCallback	on_before_sample_deserialize
	<<cert>> Callback to filter a received sample based on serialized dataWhen a DataReader receives a (serialized) sample, it will deserialize it before storing it in its queue. On_before_sample_deserialize() is called before deserialization. It allows the application to determine whether or not to drop the sample, before it is read or taken.
DDS_DataReaderListener_BeforeSampleCommitCallback	on_before_sample_commit
	<<cert>> Callback to filter a received sample based on deserialized dataWhen a DataReader receives a (serialized) sample, it will deserialize it before storing it in its queue. On_before_sample_commit() is called after deserialization, but before the sample is stored into the DataReader's queue. It allows the application to determine whether or not to drop the sample, before it is read or taken.
DDS_DataReaderListener_InstanceReplacedCallback	on_instance_replaced
	<<cert>> Handles the DDS_INSTANCE_REPLACED_STATUS communication status.This listener may only be called when the instance replacement policy is set to DDS_REPLACE_OLDEST_INSTANCE_REPLACEMENT_QOS. When a new instance is detected and resources are exhausted the oldest instance will be removed even if samples with a not read state exists for the instance. Thus, this is a forceful removal of samples and the instance. The freed instance resources will be re-used for the newly detected instance. If there are outstanding loans for the replaced instance the samples can not be freed until returned. However, when the loan is returned the samples are automatically freed. Note that the instance will not be rejected.

---

Detailed Description

<<interface>> <<cert>> DDS_Listener for reader status.

Entity:

DDS_DataReader

Status:

DDS_DATA_AVAILABLE_STATUS;
DDS_LIVELINESS_CHANGED_STATUS, DDS_LivelinessChangedStatus;
DDS_REQUESTED_DEADLINE_MISSED_STATUS, DDS_RequestedDeadlineMissedStatus;
DDS_REQUESTED_INCOMPATIBLE_QOS_STATUS, DDS_RequestedIncompatibleQosStatus;
DDS_SAMPLE_LOST_STATUS, DDS_SampleLostStatus;
DDS_SAMPLE_REJECTED_STATUS, DDS_SampleRejectedStatus;
DDS_SUBSCRIPTION_MATCHED_STATUS, DDS_SubscriptionMatchedStatus;
DDS_INSTANCE_REPLACED_STATUS, DDS_DataReaderInstanceReplacedStatus;

See also:

Status Kinds

---

Field Documentation

struct DDS_Listener DDS_DataReaderListener::as_listener

<<cert>> The superclass instance of this DDS_DataReaderListener.

DDS_DataReaderListener_RequestedDeadlineMissedCallback DDS_DataReaderListener::on_requested_deadline_missed

<<cert>> Handles the DDS_REQUESTED_DEADLINE_MISSED_STATUS communication status.

DDS_DataReaderListener_RequestedIncompatibleQosCallback DDS_DataReaderListener::on_requested_incompatible_qos

<<cert>> Handles the DDS_REQUESTED_INCOMPATIBLE_QOS_STATUS communication status.

DDS_DataReaderListener_SampleRejectedCallback DDS_DataReaderListener::on_sample_rejected

<<cert>> Handles the DDS_SAMPLE_REJECTED_STATUS communication status.

DDS_DataReaderListener_LivelinessChangedCallback DDS_DataReaderListener::on_liveliness_changed

<<cert>> Handles the DDS_LIVELINESS_CHANGED_STATUS communication status.

DDS_DataReaderListener_DataAvailableCallback DDS_DataReaderListener::on_data_available

<<cert>> Handle the DDS_DATA_AVAILABLE_STATUS communication status.

DDS_DataReaderListener_SubscriptionMatchedCallback DDS_DataReaderListener::on_subscription_matched

<<cert>> Handles the DDS_SUBSCRIPTION_MATCHED_STATUS communication status.

DDS_DataReaderListener_SampleLostCallback DDS_DataReaderListener::on_sample_lost

<<cert>> Handles the DDS_SAMPLE_LOST_STATUS communication status.

DDS_DataReaderListener_InstanceReplacedCallback DDS_DataReaderListener::on_instance_replaced

<<cert>> Handles the DDS_INSTANCE_REPLACED_STATUS communication status.This listener may only be called when the instance replacement policy is set to DDS_REPLACE_OLDEST_INSTANCE_REPLACEMENT_QOS. When a new instance is detected and resources are exhausted the oldest instance will be removed even if samples with a not read state exists for the instance. Thus, this is a forceful removal of samples and the instance. The freed instance resources will be re-used for the newly detected instance. If there are outstanding loans for the replaced instance the samples can not be freed until returned. However, when the loan is returned the samples are automatically freed. Note that the instance will not be rejected.