RTI Connext DDS Micro C++ API  Version 3.0.3
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Groups
max_samples
NAME
DDS_ResourceLimitsQosPolicy::max_samples
DESCRIPTION
DDS_ResourceLimitsQosPolicy::max_samples limits the maximum number of samples a DDSDataReader can allocate and cache. Samples are cached before they are made available to the application, for example when samples are received out-of-order. Thus, this resource-limit may impact throughput and latency.
What this value should be set to is determined by a number of factors:
  • For best-effort it can be set to 1 since samples are not cached. However, if data is polled or samples are loaned longer than the update frequency this resource-limit should be increased to prevent samples from being reused before the application has a chance to access the data (along with DDS_HistoryQosPolicy::depth).
  • For reliable data the value should take into account the data-rate, the heartbeat rate of the DDSDataWriter and the number of piggy-backed heartbeats.
SEE ALSO
DDS_HistoryQosPolicy::depth, DDS_DataWriterQos

RTI Connext DDS Micro C++ API Version 3.0.3 Copyright © Wed Jun 24 2020 Real-Time Innovations, Inc