PxToStart_Hnd()

Start timeout (handler service).

APPLIES TO

8.2.0

SYNOPSIS
PxError_t PxToStart_Hnd (PxTo_t ToId);
ARGUMENTS






ToId




Timeout object

















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










PxToStart_Hnd starts the timeout associated with ToId. This function can only be called from a handler (not 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 started. 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 = PxToStart_Hnd(ToId);

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