PxPeStop()

Stop periodic events (task service).

APPLIES TO

8.2.0

SYNOPSIS
PxError_t PxPeStop (PxPe_t PeId);
ARGUMENTS
PeId

Periodic event object

RETURN VALUES
  • PXROS error code

ERROR CODES

PXERR_PE_ILLPE

PeId is not a valid periodic event object handle

PXERR_REQUEST_ILLEGAL

The caller is not the requester of the PeId object

DESCRIPTION

PxPeStop stops signalling periodic events associated with Pe.

IMPLEMENTATION GUIDELINES
Before call
  • PeId must be a valid PXROS-HR periodic event object created with a PxPeRequest call (V). The validity of PeId may also be checked by the PxPeIsValid macro (F).

After call
  • The function returns PXERR_NOERROR if the periodic event could be stopped. 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 = PxPeStop(PeId);

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