RTI Connext Traditional C++ API  Version 5.2.0
 All Classes Functions Variables Typedefs Enumerations Enumerator Groups Pages
DDS_DynamicDataTypeSerializationProperty_t Struct Reference

Properties that govern how data of a certain type will be serialized on the network. More...

Public Attributes

DDS_Boolean use_42e_compatible_alignment
 Use RTI Connext 4.2e-compatible alignment for large primitive types.
 
DDS_UnsignedLong max_size_serialized
 The maximum number of bytes that objects of a given type could consume when serialized on the network.
 
DDS_UnsignedLong min_size_serialized
 The minimum number of bytes that objects of a given type could consume when serialized on the network.
 
DDS_Boolean trim_to_size
 Controls the growth of the serialization buffer in a DynamicData object.
 

Detailed Description

Properties that govern how data of a certain type will be serialized on the network.

Member Data Documentation

DDS_Boolean DDS_DynamicDataTypeSerializationProperty_t::use_42e_compatible_alignment

Use RTI Connext 4.2e-compatible alignment for large primitive types.

In RTI Connext 4.2e, the default alignment for large primitive types – DDS_LongLong, DDS_UnsignedLongLong, DDS_Double, and DDS_LongDouble – was not RTPS-compliant. This compatibility mode allows applications targeting post-4.2e versions of RTI Connext to interoperate with 4.2e-based applications, regardless of the data types they use.

If this flag is not set, all data will be serialized in an RTPS-compliant manner, which for the types listed above, will not be interoperable with RTI Connext 4.2e.

DDS_UnsignedLong DDS_DynamicDataTypeSerializationProperty_t::max_size_serialized

The maximum number of bytes that objects of a given type could consume when serialized on the network.

This value is used to set the sizes of certain internal middleware buffers.

The effective value of the maximum serialized size will be the value of this field or the size automatically inferred from the type's DDS_TypeCode, whichever is smaller.

DDS_UnsignedLong DDS_DynamicDataTypeSerializationProperty_t::min_size_serialized

The minimum number of bytes that objects of a given type could consume when serialized on the network.

This value is used to set the sizes of certain internal middleware buffers.

Default: 0xFFFFFFFF, a sentinel that indicates that this value must be equal to the value specified in max_size_serialized.

DDS_Boolean DDS_DynamicDataTypeSerializationProperty_t::trim_to_size

Controls the growth of the serialization buffer in a DynamicData object.

If set to 0 (default): The buffer will not be reallocated unless the serialized size of the incoming sample is greater than the current buffer size.

If set to 1: The buffer of a DynamicData object obtained from the sample pool will be reallocated to just fit the size of the serialized data of the incoming sample. The new size cannot be smaller than min_size_serialized.


RTI Connext Traditional C++ API Version 5.2.0 Copyright © Sun Jun 21 2015 Real-Time Innovations, Inc