Osys_Post_Startup_Callback_Register()
Abstract
Registers a callback used to perform post-startup processing.
Syntax
Osys_Post_Startup_Callback_Register (post_startup_proc, priority, client_state_ptr)
| Argument | Type | Description |
|---|---|---|
post_startup_proc |
OsysT_Post_Startup_Proc |
Callback to perform post-startup processing. |
priority |
int |
Priority level associated with post_startup_proc (see priority). |
client_state_ptr |
void * |
User-defined state to be passed to post_startup_proc when called. |
Return Type
void
No return value.
Header
osys_startup_funcs.h
Details
This function registers a callback that will be called to notify clients that core systems have started up and the client can begin to perform application-dependent operations such as opening dialog boxes and performing licensing checks. Typically, this function is called from an _ets_init function.
priority
- The
priorityargument can be any integer from 1 to 100, inclusive. For convenience, the following constants are defined: OSYSC_POST_STARTUP_CALLBACK_ORDER_HIGH_PRIORITY(= 1)OSYSC_POST_STARTUP_CALLBACK_ORDER_NORMAL(= 50)OSYSC_POST_STARTUP_CALLBACK_ORDER_LOW_PRIORITY(= 100)
There might be several post-startup callbacks registered. If so, priority determines the order in which the callbacks will be called. Higher priorities (lower values) are called first; ties are resolved by calling the callbacks in the order registered.
The prototype for post_startup_proc is given in OsysT_Post_Startup_Proc.