PxToStop_Hnd()

Stop timeout (handler service).

APPLIES TO

1.0.0

SYNOPSIS
PxError_t PxToStop_Hnd (PxPe_t ToId);
ARGUMENTS






ToId




Timeout handler object id

















RETURN VALUES






    

  • 

    PXROS error code
    

    • 







ERROR CODES















PXERR_REQUEST_ILLEGAL




The caller is not the requester of the ToId object








PXERR_TO_ILLTO




ToId is not a valid timeout object









DESCRIPTION










PxToStop_Hnd stops the timeout associated with ToId. This funcion can only be called from a handler (not from a task).






















IMPLEMENTATION GUIDELINES
















Before call






    

  • 

    ToId must be a valid PXROS-HR timeout object created with a PxToRequest call (V). The validity of ToId may also be checked by the PxToIsValid macro (F).
    

    • 



















After call






    

  • 

    The function returns PXERR_NOERROR if the timeout could be stopped. 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 = PxToStop_Hnd(ToId);

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