PUBLISH_MODE
[QoS Policies]

<<eXtension>> Specifies how RTI Data Distribution Service sends application data on the network. This QoS policy can be used to tell RTI Data Distribution Service to use its own thread to send data, instead of the user thread. More...

Classes

class  DDS::PublishModeQosPolicy
 Specifies how RTI Data Distribution Service sends application data on the network. This QoS policy can be used to tell RTI Data Distribution Service to use its own thread to send data, instead of the user thread. More...

Enumerations

enum  DDS::PublishModeQosPolicyKind {
  DDS::SYNCHRONOUS_PUBLISH_MODE_QOS,
  DDS::ASYNCHRONOUS_PUBLISH_MODE_QOS
}
 Kinds of publishing mode. More...

Functions

static System::String^ DDS::PublishModeQosPolicy::get_publishmode_qos_policy_name ()
 Stringified human-readable name for DDS::PublishModeQosPolicy.

Detailed Description

<<eXtension>> Specifies how RTI Data Distribution Service sends application data on the network. This QoS policy can be used to tell RTI Data Distribution Service to use its own thread to send data, instead of the user thread.


Enumeration Type Documentation

Kinds of publishing mode.

QoS:
DDS::PublishModeQosPolicy
Enumerator:
SYNCHRONOUS_PUBLISH_MODE_QOS  Indicates to send data synchronously.

If DDS::DataWriterProtocolQosPolicy::push_on_write is true, data is sent immediately in the context of DDS::TypedDataWriter::write.

As data is sent immediately in the context of the user thread, no flow control is applied.

See also:
DDS::DataWriterProtocolQosPolicy::push_on_write
[default] for DDS::DataWriter
ASYNCHRONOUS_PUBLISH_MODE_QOS  Indicates to send data asynchronously.

Configures the DDS::DataWriter to delegate the task of data transmission to a separate publishing thread. The DDS::TypedDataWriter::write call does not send the data, but instead schedules the data to be sent later by its associated DDS::Publisher.

Each DDS::Publisher uses its dedicated publishing thread (DDS::PublisherQos::asynchronous_publisher) to send data for all its asynchronous DataWriters. For each asynchronous DataWriter, the associated DDS::FlowController determines when the publishing thread is allowed to send the data.

DDS::DataWriter::wait_for_asynchronous_publishing and DDS::Publisher::wait_for_asynchronous_publishing enable you to determine when the data has actually been sent.

Note: DDS::DataWriterProtocolQosPolicy::push_on_write must be TRUE for Asynchronous DataWriters. Otherwise, samples will never be sent.

See also:
DDS::FlowController

DDS::HistoryQosPolicy

DDS::DataWriter::wait_for_asynchronous_publishing

DDS::Publisher::wait_for_asynchronous_publishing

DDS::Transport_Property_t::gather_send_buffer_count_max


Function Documentation

static System::String ^ DDS::PublishModeQosPolicy::get_publishmode_qos_policy_name (  )  [inline, static, inherited]

Stringified human-readable name for DDS::PublishModeQosPolicy.


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