RTI Connext C API  Version 6.1.1

Specifies the DDS_AsyncWaitSet behavior. More...

Data Fields

struct DDS_WaitSetProperty_t waitset_property
 Specifies the behavior of the asynchronous wait behavior, which is equivalent to the wait mechanism of a DDS_WaitSet. More...
 
DDS_UnsignedLong thread_pool_size
 Number of threads that conform the thread pool of the DDS_AsyncWaitSet. More...
 
struct DDS_ThreadSettings_t thread_settings
 DDS_ThreadSettings_t for each thread conforming the thread pool of the DDS_AsyncWaitSet. More...
 
char * thread_name_prefix
 Prefix used to composed the name of each thread that conforms the thread pool the DDS_AsyncWaitSet. More...
 
struct DDS_Duration_t wait_timeout
 Asynchronous wait timeout. More...
 
DDS_Long level
 Specifies the level of an DDS_AsyncWaitSet. More...
 

Detailed Description

Specifies the DDS_AsyncWaitSet behavior.

This property allows configuring the behavior of the asynchronous wait and the DDS_Condition dispatch, as well as the parameters of the thread pool.

See also
DDS_WaitSetProperty_t
DDS_ThreadSettings_t

Field Documentation

◆ waitset_property

struct DDS_WaitSetProperty_t DDS_AsyncWaitSetProperty_t::waitset_property

Specifies the behavior of the asynchronous wait behavior, which is equivalent to the wait mechanism of a DDS_WaitSet.

[default] DDS_WaitSetProperty_t_INITIALIZER

See also
DDS_WaitSetProperty_t

◆ thread_pool_size

DDS_UnsignedLong DDS_AsyncWaitSetProperty_t::thread_pool_size

Number of threads that conform the thread pool of the DDS_AsyncWaitSet.

Size must be equal or greater than one.

[default] 1

◆ thread_settings

struct DDS_ThreadSettings_t DDS_AsyncWaitSetProperty_t::thread_settings

DDS_ThreadSettings_t for each thread conforming the thread pool of the DDS_AsyncWaitSet.

Each thread within the pool is created with the same settings.

[default] Default thread settings values.

See also
DDS_ThreadSettings_t

◆ thread_name_prefix

char* DDS_AsyncWaitSetProperty_t::thread_name_prefix

Prefix used to composed the name of each thread that conforms the thread pool the DDS_AsyncWaitSet.

The composed name has the form:

thread_name_prefix##[index]AWs where [index] is an integer that identifies the thread relative to the DDS_AsyncWaitSet.

If NULL, the default prefix will be used.

[default] NULL (use default prefix)

◆ wait_timeout

struct DDS_Duration_t DDS_AsyncWaitSetProperty_t::wait_timeout

Asynchronous wait timeout.

Specifies the maximum amount of time the leader thread of the DDS_AsyncWaitSet waits for an attached DDS_Condition to trigger before it wakes up.

Duration must be a value greater than zero.

See also
DDS_WaitSet_wait

[default] DDS_DURATION_INFINITE

◆ level

DDS_Long DDS_AsyncWaitSetProperty_t::level

Specifies the level of an DDS_AsyncWaitSet.

The level prevents an application to deadlock when it uses multiple DDS_AsyncWaitSet instances that call operations on each other from the context of one of their thread pool's thread.

Inside the context of one of these threads, the application can synchronize only with other DDS_AsyncWaitSet of bigger level.

[default] 1