PxTaskSuspend_Hnd()

Prevent a task from being scheduled (handler service).

APPLIES TO

1.0.0

SYNOPSIS
PxError_t PxTaskSuspend_Hnd (PxTask_t TaskId);
ARGUMENTS






TaskId




Task to be suspended

















RETURN VALUES






    

  • 

    PXROS error code
    

    • 







ERROR CODES















PXERR_ACCESS_RIGHT




the calling task has not the right to suspend other tasks








PXERR_GLOBAL_ILLEGAL_CORE




the requested task is not on the same core








PXERR_TASK_ILLRDYFUN




invalid ready function detected








PXERR_TASK_ILLTASK




TaskId is not a valid task object









DESCRIPTION










PxTaskSuspend_Hnd suspends task, i.e., prevents task from being scheduled. If the task is waiting for a resource, the resource may eventually be delivered to task but task remains in a waiting state until resumed by PxTaskResume. This function can only be called from handler.






















IMPLEMENTATION GUIDELINES
















Before call






    

  • 

    The parameter TaskId must be a valid task object id. This id may be
    

    

      

    • 

      the calling task’s own id read by calling PxGetId() (V)
      

      • 

    • 

      the return value of a PxTaskCreate() call (V)
      

      • 

    • 

      the result of a nameserver query (V)
      

      • 

    • 

      part of a message sent by another task (V)
      

      • 

    

    

    • 

  • 

    The task object must be created on the same core as the caller runs on. The creator core id can be read with the macro PxTaskCoreId and the own core id with PxGetCoreId (C).
Additionally the task id may be checked with PxTaskCheck() (F).
    

    • 



















After call






    

  • 

    The function returns PXERR_NOERROR if the task could be suspended. Any other return value describes an error, which has to be interpreted (C).
    

    • 



















Best Practice






    

  • 

    This function should be called from handlers only. (V)
    

    • 






























SEE ALSO











USAGE








#include "pxdef.h"

PxError_t err = PxTaskSuspend_Hnd(TaskId);

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