DDS::WaitSetProperty_t Struct Reference
[Conditions and WaitSets]

<<eXtension>> Specifies the DDS::WaitSet behavior for multiple trigger events. More...

#include <managed_infrastructure.h>

List of all members.

Public Attributes

System::Int32 max_event_count
 Maximum number of trigger events to cause a DDS::WaitSet to awaken.
Duration_t max_event_delay
 Maximum delay from occurrence of first trigger event to cause a DDS::WaitSet to awaken.


Detailed Description

<<eXtension>> Specifies the DDS::WaitSet behavior for multiple trigger events.

In simple use, a DDS::WaitSet returns when a single trigger event occurs on one of its attached DDS::Condition (s), or when the timeout maximum wait duration specified in the DDS::WaitSet::wait call expires.

The DDS::WaitSetProperty_t allows configuration of a DDS::WaitSet to wait for up to max_event_count trigger events to occur before returning, or to wait for up to max_event_delay time from the occurrence of the first trigger event before returning.

The timeout maximum wait duration specified in the DDS::WaitSet::wait call continues to apply.

Entity:
DDS::WaitSet
Properties:
RxO = N/A
Changeable = YES

Member Data Documentation

Maximum number of trigger events to cause a DDS::WaitSet to awaken.

The DDS::WaitSet will wait until up to max_event_count trigger events have occurred before returning. The DDS::WaitSet may return earlier if either the timeout duration has expired, or max_event_delay has elapsed since the occurrence of the first trigger event. max_event_count may be used to "collect" multiple trigger events for processing at the same time.

[default] 1

[range] >= 1

;

Maximum delay from occurrence of first trigger event to cause a DDS::WaitSet to awaken.

The DDS::WaitSet will return no later than max_event_delay after the first trigger event. max_event_delay may be used to establish a maximum latency for events reported by the DDS::WaitSet.

Note that DDS::Retcode_Timeout is not returned if max_event_delay is exceeded. DDS::Retcode_Timeout is returned only if the timeout duration expires before any trigger events occur.

[default] DDS::Duration_t::DURATION_INFINITE;


RTI Data Distribution Service .Net APIs Version 4.5e Copyright © 23 Oct 2011 Real-Time Innovations, Inc