MSG

PXSvMsgReceive PXVT_MSG

Fn

PxMsgReceive()

A1

ID of the received message object or invalid ID on failure

A2

ID of the mailbox object from which to get a message

Fn

PxMsgReceive() error codes

PXSvMsgReceive_Waiting PXVT_MSG

Fn

PxMsgReceive()

A2

ID of the mailbox object from which to get a message

PXSvMsgReceive_EvWait PXVT_MSG, PXVT_EVENT

Fn

PxMsgReceive_EvWait()

A1

ID of the received message object if the message was received or invalid ID on failure/event abortion

A2

Events, if the receive was aborted by a waiting event

Er

PxMsgReceive_EvWait() error codes

PXSvMsgReceive_EvWait_Waiting PXVT_MSG, PXVT_EVENT

Fn

PxMsgReceive_EvWait()

A1

ID of the mailbox object from which to get a message

A2

Events to wait for

PXSvMsgReceive_NoWait PXVT_MSG

Fn

PxMsgReceive_NoWait()

A1

ID of the received message object or invalid ID on failure

A2

ID of the mailbox object from which to get a message

Er

PxMsgReceive_NoWait() error codes

PXSvMsgSend PXVT_MSG

Fn

Internal function to send a message

A1

Invalid ID if the send was successful or ID of the message object to send

A2

ID of the mailbox object where to send the message

Er

PXERR_MSG_ILLMSG, PXERR_MBX_ILLMBX, PXERR_MSG_ILLUSER

PXSvMsgRequest PXVT_MSG

Fn

1) PxMsgRequest()

2) PxMsgRequest_EvWait()

3) PxMsgRequest_NoWait()

A1

1) ID of the requested message object

2) ID of the requested message object or invalid ID if the request was aborted by a waiting event

3) ID of the requested message object if the request was successful or invalid ID on failure

A2

ID of the memory class from which the block is taken

Er

1) PxMsgRequest() error codes

2) PxMsgRequest_EvWait() error codes

3) PxMsgRequest_NoWait() error codes

PXSvMsgEnvelop PXVT_MSG

Fn

PxMsgEnvelop()

A1

The beginning of the data area to be enveloped

A2

Data area’s size in bytes

Er

PxMsgEnvelop() error codes

PXSvMsgEnvelop_EvWait PXVT_MSG, PXVT_EVENT

Fn

PxMsgEnvelop_EvWait()

A1

The beginning of the data area to be enveloped

A2

Data area’s size in bytes

Er

PxMsgEnvelop_EvWait() error codes

PXSvMsgEnvelop_NoWait PXVT_MSG

Fn

PxMsgEnvelop_NoWait()

A1

The beginning of the data area to be enveloped

A2

Data area’s size in bytes

Er

PxMsgEnvelop_NoWait() error codes

PXSvMsgRelease PXVT_MSG

Fn

PxMsgRelease()

A1

ID of the message object to release

Er

PxMsgRelease() error codes

PXSvMsgSetSize PXVT_MSG

Fn

PxMsgSetSize()

A1

ID of the message object which size to set

A2

Size of the message to set in bytes

Er

PxMsgSetSize() error codes

PXSvMsgInstallRelmbx PXVT_MSG

Fn

PxMsgInstallRelmbx()

A1

ID of the message object for which to install the release mailbox

A2

ID of the mailbox object to be used as release mailbox

Er

PxMsgInstallRelmbx() error codes

PXSvMsgAwaitRel PXVT_MSG

Fn

PxMsgAwaitRel()

A1

ID of the message object that was waited for

A2

Message type or it may/may not be 0 if the message released/aborted by an event

Message types for this tracing service:

1) PXMsgEnveloped: (1<<0)

2) PXMsgRequested: (1<<1)

3) PXMsgAwaitRelease: (1<<5)

4) PXMsgReleased: (1<<6)

5) PXMsgRelMbx: (1<<7)

Er

PxMsgAwaitRel() error codes

PXSvMsgAwaitRel_Waiting PXVT_MSG

Fn

PxMsgAwaitRel()

A1

ID of the message object that is waited for

PXSvMsgAwaitRel_EvWait PXVT_MSG, PXVT_EVENT

Fn

PxMsgAwaitRel_EvWait()

A1

ID of the message object to wait for or invalid ID on failure/event abortion

A2

Events, if the waiting was aborted by a waiting event

Er

PxMsgAwaitRel_EvWait() error codes

PXSvMsgAwaitRel_EvWait_Waiting PXVT_MSG, PXVT_EVENT

Fn

PxMsgAwaitRel_EvWait()

A1

ID of the message object to wait for

A2

Events to wait for

PXSvMsgAwaitRel_NoWait PXVT_MSG

Fn

PxMsgAwaitRel_NoWait()

A1

ID of the message object which release is checked or invalid ID if the function is called with an invalid ID

Er

PxMsgAwaitRel_NoWait() error codes

PXSvMsgSetToAwaitRel PXVT_MSG

Fn

PxMsgSetToAwaitRel()

A1

ID of the message object to mark for await release

Er

PxMsgSetToAwaitRel() error codes

PXSvMsgReleaseAllMsg PXVT_MSG

Fn

PxMsgReleaseAllMsg()

Er

PxMsgReleaseAllMsg() error codes

PXSvMsgGetData PXVT_MSG

Fn

PxMsgGetData()

A1

ID of the message object which data to get

A2

The beginning of the message data area or 0 on failure

Er

PxMsgGetData() error codes

PXSvMsgRelDataAccess PXVT_MSG

Fn

PxMsgRelDataAccess()

A1

ID of the message object which access to the message data area to release

Er

PxMsgRelDataAccess() error codes

PXSvMsgGetSize PXVT_MSG

Fn

PxMsgGetSize()

A1

ID of the message object which size to get

A2

Size of the message in bytes or 0 on failure

Er

PxMsgGetSize() error codes

PXSvMsgGetBuffersize PXVT_MSG

Fn

PxMsgGetBuffersize()

A1

ID of the message object which buffer size to get

A2

Size of the message data area in bytes or 0 on failure

Er

PxMsgGetBuffersize() error codes

PXSvMsgGetOwner PXVT_MSG

Fn

PxMsgGetOwner()

A1

ID of the message object which owner to get

A2

ID of the task object being the owner of the message or invalid ID on failure

Er

PxMsgGetOwner() error codes

PXSvMsgGetProtection PXVT_MSG

Fn

PxMsgGetProtection()

A1

ID of the message object which protection mode to get

A2

PxProtectType_t protection mode or NoAccessProtection on failure

Er

PxMsgGetProtection() error codes

PXSvMsgSetProtection PXVT_MSG

Fn

PxMsgSetProtection()

A1

ID of the message object which protection mode to set

A2

PxProtectType_t protection mode to set

Er

PxMsgSetProtection() error codes

PXSvMsgForceRelease PXVT_MSG

Fn

PxMsgForceRelease()

Er

PxMsgForceRelease() error codes

PXSvMsgSetData PXVT_MSG

Fn

PxMsgSetData()

A1

ID of the message object which message data to set

A2

The beginning of the data area to set

Er

PxMsgSetData() error codes

PXSvMsgGetSender PXVT_MSG

Fn

PxMsgGetSender()

A1

ID of the message object which sender to get

A2

ID of the task object being the sender of the message or invalid ID on failure

Er

PxMsgGetSender() error codes

PXSvMsgGetMetadata PXVT_MSG

Fn

PxMsgGetMetadata()

A1

ID of the message object which message metadata to get

A2

Lower 32 bits of the message metadata or 0 on failure

Fn

PxMsgGetMetadata() error codes

PXSvMsgSetMetadata PXVT_MSG

Fn

PxMsgSetMetadata()

A1

ID of the message object which message metadata to set

A2

Lower 32 bits of the message metadata

Er

PxMsgSetMetadata() error codes

PXSvMsgGetData_Hnd PXVT_MSG, PXVT_HND

Fn

PxMsgGetData_Hnd()

A1

ID of the message object which message data to get

A2

The beginning of the message data area or 0 on failure

Er

PxMsgGetData_Hnd() error codes

PXSvMsgSend_Hnd PXVT_MSG, PXVT_HND

Fn

1) Internal function for PxMsgSend_Hnd(), PxMsgSend_PrioHnd()

2) Internal postservice for handler send (message send service)

A1

1) Invalid ID if send was successful or ID of the message object to send on failure

2) ID of the message object to send

A2

ID of the mailbox object to send the message to

Er

1) PxMsgSend_Hnd() and PxMsgSend_PrioHnd() error codes

PXSvMsgRelease_Hnd PXVT_MSG, PXVT_HND

Fn

1) PxMsgRelease_Hnd()

2) Internal postservice for handler release (message release service)

A1

1) Invalid ID if the release was successful or ID of the release mailbox object of the message to release if both message and mailbox objects are from cores different than the caller’s and release mailbox is installed and no other task is waiting for the message or ID of the message object to release on failure

2) Invalid ID if error or ID of the message object to release

Er

1) PxMsgRelease_Hnd() error codes

2) PXERR_MSG_ILLMSG, PXERR_GLOBAL_ILLEGAL_CORE, PXERR_REQUEST_ILLEGAL — release to release mailbox is already done in PxMsgRelease_Hnd(), PXERR_MSG_ILLOWNER, PXERR_MC_ILLMC, PXERR_OPOOL_ILLOPOOL

PXSvMsgGetMetadata_Hnd PXVT_MSG, PXVT_HND

Fn

PxMsgGetMetadata_Hnd()

A1

ID of the message object which message metadata to get

A2

Lower 32 bits of the message metadata or 0 on failure

Er

PxMsgGetMetadata_Hnd() error codes

PXSvMsgSetMetadata_Hnd PXVT_MSG, PXVT_HND

Fn

PxMsgSetMetadata_Hnd()

A1

ID of the message object which message metadata to set

A2

Lower 32 bits of the message metadata to set

Er

PxMsgSetMetadata_Hnd() error codes