PxIsOnHndLvl()

Retrives the handler or task type.

APPLIES TO

8.2.0

SYNOPSIS
PxInt_t PxIsOnHndLvl(void);
RETURN VALUES

  • Pointer to the protection set

DESCRIPTION

Retrieves whether the calling function is running on task (non-privileged) or kernel/handler level (privileged). It can be used to determine whether a task level API function or the _hnd variant must be called.

IMPLEMENTATION GUIDELINES
Before call

  • No checks necessary.
After call

  • No checks necessary.
Best Practice

  • No restrictions.
SEE ALSO
USAGE
#include "pxdef.h"

if (PxIsOnHndLvl())
    PxTaskSignalEvents_Hnd(Task, EVENT_SUCCESS);
else
    PxTaskSignalEvents(Task, EVENT_SUCCESS);