PxDieService()

The PXROS die service.

APPLIES TO

1.0.0

SYNOPSIS
PxError_t PxDieService (void);
RETURN VALUES
  • PXROS error code

ERROR CODES

PXERR_OPOOL_ILLOPOOL

The object pool is not valid

PXERR_GLOBAL_ILLEGAL_CORE

The requested object pool is not on the same core

PXERR_TASK_ILLTASK

The task is not a valid task object

PXERR_INIT_ILLMCTYPE

The type for PXMcSystemdefault is different from PXMcVarsized, PXMcVarsizedAdjusted and PXMcVarsizedAligned

PXERR_MC_ILLMC

Invalid memory class

PXERR_MC_DAMAGED_BLOCK

The block in the memory class has been damaged

PXERR_MC_INCONSISTENCY

Inconsistency in memory class: blk

PXERR_MC_ILLALIGN

Invalid memory block or size alignment in memory insert

PXERR_MC_ILLSIZE

Insufficient block size

PXERR_INTERNAL_INCONSISTENCY

Inconsistency of internal structures

DESCRIPTION

PxDieService removes a task from the system which has called PxDie before. This function has to be called by the PXROS service task after receiving the event PXSERVICE_TASK_DIED.

IMPLEMENTATION GUIDELINES
Before call
  • No checks necessary.

After call
  • The function returns PXERR_NOERROR if the die service was successfully executed. Any other return value describes an error, which has to be interpreted (C).

Best Practice
  • No restrictions.

SEE ALSO
USAGE
#include "pxdef.h"

PxError_t err = PxDieService();

if (err != PXERR_NOERROR) {
    // Report error
}