RTEMS 4.7.2 On-Line Library

Partition Manager PARTITION_GET_BUFFER - Get buffer from a partition

RTEMS C User's Guide

13.4.4: PARTITION_GET_BUFFER - Get buffer from a partition

CALLING SEQUENCE:

rtems_status_code rtems_partition_get_buffer(
  rtems_id   id,
  void     **buffer
);

DIRECTIVE STATUS CODES:

RTEMS_SUCCESSFUL - buffer obtained successfully
RTEMS_INVALID_ADDRESS - buffer is NULL
RTEMS_INVALID_ID - invalid partition id
RTEMS_UNSATISFIED - all buffers are allocated

DESCRIPTION:

This directive allows a buffer to be obtained from the partition specified in id. The address of the allocated buffer is returned in buffer.

NOTES:

This directive will not cause the running task to be preempted.

All buffers begin on a four byte boundary.

A task cannot wait on a buffer to become available.

Getting a buffer from a global partition which does not reside on the local node will generate a request telling the remote node to allocate a buffer from the specified partition.

RTEMS C User's Guide