Mirrors_Framework/nuttx
1
0
Fork 0
mirror of https://github.com/apache/nuttx.git synced 2026-06-08 01:42:58 +08:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Add nx_eventnotify.c

Browse Source 
git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@1349 42af7a65-404d-4744-a932-0658087f49c3
This commit is contained in:
patacongo
2008-11-29 18:12:17 +00:00
parent f48db4efac
commit fccb66a0be
3 changed files with 150 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
include/nuttx/nx.h
+40 -8
View File
@@ -321,24 +321,56 @@ EXTERN void nx_close(NXHANDLE handle);
* Description:
* The client code must call this function periodically to process
* incoming messages from the server. If CONFIG_NX_BLOCKING is defined,
* then this function will never return until the host is disconnected.
* then this function not return until a server message is received.
*
* When CONFIG_NX_BLOCKING is not defined, the client must exercise
* caution in the looping to assure that it does not eat up all of
* the CPU bandwidth calling nx_eventhandler repeatedly. nx_eventnotify
* may be called to get a signal event whenever a new incoming server
* event is avaiable.
*
* Input Parameters:
* handle - the handle returned by nx_connect
*
* Return:
* >0: The length of the message received in msgbuffer
* 0: No message was received
* <0: An error occurred and errno has been set appropriately
*
* Of particular interest, it will return errno == EHOSTDOWN when the
* server is disconnected. After that event, the handle can not longer
* be used.
* OK: No errors occurred. If CONFIG_NX_BLOCKING is defined, then
* one or more server message was processed.
* ERROR: An error occurred and errno has been set appropriately. Of
* particular interest, it will return errno == EHOSTDOWN when the
* server is disconnected. After that event, the handle can no
* longer be used.
*
****************************************************************************/
#ifdef CONFIG_NX_MULTIUSER
EXTERN int nx_eventhandler(NXHANDLE handle);
#else
# define nx_eventhandler(handle) (OK)
#endif
/****************************************************************************
* Name: nx_eventnotify
*
* Description:
* Rather than calling nx_eventhandler periodically, the client may
* register to receive a signal when a server event is available. The
* client can then call nv_eventhandler() only when incoming events are
* available.
*
* Input Parameters:
* handle - the handle returned by nx_connect
*
* Return:
* OK: No errors occurred. If CONFIG_NX_BLOCKING is defined, then
* one or more server message was processed.
* ERROR: An error occurred and errno has been set appropriately
*
****************************************************************************/
#if defined(CONFIG_NX_MULTIUSER) && !defined(CONFIG_DISABLE_SIGNALS)
EXTERN int nx_eventnotify(NXHANDLE handle, int signo);
#else
# define nx_eventnotify(handle, signo) (OK)
#endif
/****************************************************************************