RTEMS 4.7.2 On-Line Library

Partition Manager PARTITION_GET_BUFFER - Get buffer from a partition

RTEMS Ada User's Guide

13.4.4: PARTITION_GET_BUFFER - Get buffer from a partition

CALLING SEQUENCE:

procedure Partition_Get_Buffer (
   ID     : in     RTEMS.ID;
   Buffer :    out RTEMS.Address;
   Result :    out RTEMS.Status_Codes
);

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 Ada User's Guide