SchedRegisterExternalEvent (FUN)

FUNCTION SchedRegisterExternalEvent : RTS_IEC_HANDLE

<description> <p>Register an external event, which might be used later by event tasks. You should register those events during the system startup, so that the scheduler knows all events when the application is loaded.</p> <p>Valid Hook: CH_INIT2</p> <p>Note: the parameter pszExtEventName needs to be constantly allocated. It might either be a constant string, a global string variable, or a dynamically allocated string. But the memory needs to be valid during the life time of the event handle.</p> </description> <param name=”pszExtEventName” type=”IN”>Name of the event, as it was specified in the device description. This parameter needs to be constantly allocated</param> <param name=”pResult” type=”INOUT”>Error Code</param> <errorcode name=”RTS_IEC_RESULT” type=”ERR_OK”>Event was registered successfully</errorcode> <errorcode name=”RTS_IEC_RESULT” type=”ERR_NOMEMORY”>There was not enough memory to register the new event handle</errorcode> <result>handle to the event</result>

InOut:

Scope	Name	Type
Return	SchedRegisterExternalEvent	RTS_IEC_HANDLE
Input	pszExtEventName	REFERENCE TO STRING
	pResult	POINTER TO RTS_IEC_RESULT