RTI Connext C API  Version 5.1.0
DDS_EventQosPolicy Struct Reference

Settings for event. More...

Data Fields

struct DDS_ThreadSettings_t thread
 Event thread QoS.
 
DDS_Long initial_count
 The initial number of events.
 
DDS_Long max_count
 The maximum number of events.
 

Detailed Description

Settings for event.

In a DDS_DomainParticipant, a thread is dedicated to handle all timed events, including checking for timeouts and deadlines and executing internal and user-defined timeout or exception handling routines/callbacks.

This QoS policy allows you to configure thread properties such as priority level and stack size. You can also configure the maximum number of events that can be posted to the event thread. By default, a DDS_DomainParticipant will dynamically allocate memory as needed for events posted to the event thread. However, by setting a maximum value or setting the initial and maximum value to be the same, you can either bound the amount of memory allocated for the event thread or prevent a DDS_DomainParticipant from dynamically allocating memory for the event thread after initialization.

This QoS policy is an extension to the DDS standard.

Entity:
DDS_DomainParticipant
Properties:
RxO = N/A
Changeable = NO

Field Documentation

struct DDS_ThreadSettings_t DDS_EventQosPolicy::thread

Event thread QoS.

There is only one event thread.

Priority:
[default] The actual value depends on your architecture:
For Windows: -2
For Linux: OS default priority
For a complete list of platform specific values, please refer to Platform Notes.

Stack Size:
[default] The actual value depends on your architecture:
For Windows: OS default stack size
For Linux: OS default stack size
For a complete list of platform specific values, please refer to Platform Notes.

Mask:
[default] mask = DDS_THREAD_SETTINGS_FLOATING_POINT | DDS_THREAD_SETTINGS_STDIO

DDS_Long DDS_EventQosPolicy::initial_count

The initial number of events.

[default] 256

[range] [1, 1 million], <= max_count

DDS_Long DDS_EventQosPolicy::max_count

The maximum number of events.

The maximum number of events. If the limit is reached, no new event can be added.

[default] DDS_LENGTH_UNLIMITED

[range] [1, 1 million] or DDS_LENGTH_UNLIMITED, >= initial_count


RTI Connext C API Version 5.1.0 Copyright © Mon Feb 3 2014 Real-Time Innovations, Inc