diff options
Diffstat (limited to 'c-user/message/directives.rst')
| -rw-r--r-- | c-user/message/directives.rst | 29 |
1 files changed, 15 insertions, 14 deletions
diff --git a/c-user/message/directives.rst b/c-user/message/directives.rst index 7317eb4..7039b2e 100644 --- a/c-user/message/directives.rst +++ b/c-user/message/directives.rst @@ -1,6 +1,6 @@ .. SPDX-License-Identifier: CC-BY-SA-4.0 -.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de) +.. Copyright (C) 2020, 2021 embedded brains GmbH & Co. KG .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) .. This file is part of the RTEMS quality process and was automatically @@ -72,9 +72,9 @@ Creates a message queue. This parameter is the attribute set of the message queue. ``id`` - This parameter is the pointer to an :c:type:`rtems_id` object. When the - directive call is successful, the identifier of the created message queue - will be stored in this object. + This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When + the directive call is successful, the identifier of the created message + queue will be stored in this object. .. rubric:: DESCRIPTION: @@ -230,11 +230,12 @@ Constructs a message queue from the specified the message queue configuration. .. rubric:: PARAMETERS: ``config`` - This parameter is the message queue configuration. + This parameter is the pointer to an :ref:`InterfaceRtemsMessageQueueConfig` + object. It configures the message queue. ``id`` - This parameter is the pointer to an :c:type:`rtems_id` object. When the - directive call is successful, the identifier of the constructed message + This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When + the directive call is successful, the identifier of the constructed message queue will be stored in this object. .. rubric:: RETURN VALUES: @@ -361,9 +362,9 @@ Identifies a message queue by the object name. This parameter is the node or node set to search for a matching object. ``id`` - This parameter is the pointer to an :c:type:`rtems_id` object. When the - directive call is successful, the object identifier of an object with the - specified name will be stored in this object. + This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When + the directive call is successful, the object identifier of an object with + the specified name will be stored in this object. .. rubric:: DESCRIPTION: @@ -727,7 +728,7 @@ Broadcasts the messages to the tasks waiting at the queue. This directive causes all tasks that are waiting at the queue specified by ``id`` to be unblocked and sent the message contained in ``buffer``. Before a -task is unblocked, the message ``buffer`` of ``size`` byes in length is copied +task is unblocked, the message ``buffer`` of ``size`` bytes in length is copied to that task's message buffer. The number of tasks that were unblocked is returned in ``count``. @@ -1014,8 +1015,8 @@ Flushes all messages on the queue. ``count`` This parameter is the pointer to an `uint32_t <https://en.cppreference.com/w/c/types/integer>`_ object. When the - directive call is successful, the number of unblocked tasks will be stored - in this object. + directive call is successful, the number of pending messages removed from + the queue will be stored in this object. .. rubric:: DESCRIPTION: @@ -1072,7 +1073,7 @@ the specified maximum size. .. code-block:: c - #define RTEMS_MESSAGE_QUEUE_BUFFER( maximum_message_size ) + RTEMS_MESSAGE_QUEUE_BUFFER( size_t maximum_message_size ); .. rubric:: PARAMETERS: |