home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xprocessinternalconnection.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  5.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XAddConnectionWatch(3X11) XLIB FUNCTIONSXAddConnectionWatch(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XAddConnectionWatch, XRemoveConnectionWatch, XProcessIn-
  9.        ternalConnection, XInternalConnectionNumbers - handle Xlib
  10.        internal connections
  11.  
  12. SSYYNNTTAAXX
  13.        typedef void (*XConnectionWatchProc)(_d_i_s_p_l_a_y, _c_l_i_e_n_t___d_a_t_a,
  14.        _f_d, _o_p_e_n_i_n_g, _w_a_t_c_h___d_a_t_a)
  15.          Display *_d_i_s_p_l_a_y;
  16.          XPointer _c_l_i_e_n_t___d_a_t_a;
  17.          int _f_d;
  18.          Bool _o_p_e_n_i_n_g;
  19.          XPointer *_w_a_t_c_h___d_a_t_a;
  20.  
  21.        Status XAddConnectionWatch(_d_i_s_p_l_a_y, _p_r_o_c_e_d_u_r_e,
  22.        _c_l_i_e_n_t___d_a_t_a)
  23.          Display *_d_i_s_p_l_a_y;
  24.          XWatchProc _p_r_o_c_e_d_u_r_e;
  25.          XPointer _c_l_i_e_n_t___d_a_t_a;
  26.  
  27.        Status XRemoveConnectionWatch(_d_i_s_p_l_a_y, _p_r_o_c_e_d_u_r_e,
  28.        _c_l_i_e_n_t___d_a_t_a)
  29.          Display *_d_i_s_p_l_a_y;
  30.          XWatchProc _p_r_o_c_e_d_u_r_e;
  31.          XPointer _c_l_i_e_n_t___d_a_t_a;
  32.  
  33.        void XProcessInternalConnection(_d_i_s_p_l_a_y, _f_d)
  34.          Display *_d_i_s_p_l_a_y;
  35.          int _f_d;
  36.  
  37.        void XProcessInternalConnection(_d_i_s_p_l_a_y, _f_d)
  38.          Display *_d_i_s_p_l_a_y;
  39.          int _f_d;
  40.  
  41.        Status XInternalConnectionNumbers(_d_i_s_p_l_a_y, _f_d___r_e_t_u_r_n,
  42.        _c_o_u_n_t___r_e_t_u_r_n)
  43.          Display *_d_i_s_p_l_a_y;
  44.          int **_f_d___r_e_t_u_r_n;
  45.          int *_c_o_u_n_t___r_e_t_u_r_n;
  46.  
  47. AARRGGUUMMEENNTTSS
  48.        _c_l_i_e_n_t___d_a_t_a
  49.          Specifies the additional client data.
  50.  
  51.        _c_o_u_n_t___r_e_t_u_r_n
  52.          Returns the number of file descriptors.
  53.  
  54.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  55.  
  56.        _f_d     Specifies the file descriptor.
  57.  
  58.        _f_d___r_e_t_u_r_n Returns the file descriptors.
  59.  
  60.        _p_r_o_c_e_d_u_r_e Specifies the procedure to be called.
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XAddConnectionWatch(3X11) XLIB FUNCTIONSXAddConnectionWatch(3X11)
  71.  
  72.  
  73. DDEESSCCRRIIPPTTIIOONN
  74.        The _X_A_d_d_C_o_n_n_e_c_t_i_o_n_W_a_t_c_h function registers a procedure to
  75.        be called each time Xlib opens or closes an internal con-
  76.        nection for the specified display.  The procedure is
  77.        passed the display, the specified client_data, the file
  78.        descriptor for the connection, a Boolean indicating
  79.        whether the connection is being opened or closed, and a
  80.        pointer to a location for private watch data.  If opening
  81.        is _T_r_u_e, the procedure can store a pointer to private data
  82.        in the location pointed to by watch_data; when the proce-
  83.        dure is later called for this same connection and opening
  84.        is _F_a_l_s_e, the location pointed to by watch_data will hold
  85.        this same private data pointer.
  86.  
  87.        This function can be called at any time after a display is
  88.        opened.    If internal connections already exist, the regis-
  89.        tered procedure will immediately be called for each of
  90.        them, before _X_A_d_d_C_o_n_n_e_c_t_i_o_n_W_a_t_c_h returns.  _X_A_d_d_C_o_n_n_e_c_t_i_o_n_-
  91.        _W_a_t_c_h returns a nonzero status if the procedure is suc-
  92.        cessfully registered; otherwise, it returns zero.
  93.  
  94.        The registered procedure should not call any Xlib func-
  95.        tions.  If the procedure directly or indirectly causes the
  96.        state of internal connections or watch procedures to
  97.        change, the result is not defined.  If Xlib has been ini-
  98.        tialized for threads, the procedure is called with the
  99.        display locked and the result of a call by the procedure
  100.        to any Xlib function that locks the display is not defined
  101.        unless the executing thread has externally locked the dis-
  102.        play using _X_L_o_c_k_D_i_s_p_l_a_y.
  103.  
  104.        The _X_R_e_m_o_v_e_C_o_n_n_e_c_t_i_o_n_W_a_t_c_h function removes a previously
  105.        registered connection watch procedure.  The client_data
  106.        must match the client_data used when the procedure was
  107.        initially registered.
  108.  
  109.  
  110.        The _X_P_r_o_c_e_s_s_I_n_t_e_r_n_a_l_C_o_n_n_e_c_t_i_o_n function processes input
  111.        available on an internal connection.  This function should
  112.        be called for an internal connection only after an operat-
  113.        ing system facility (for example, _s_e_l_e_c_t or _p_o_l_l) has
  114.        indicated that input is available; otherwise, the effect
  115.        is not defined.
  116.  
  117.        The _X_P_r_o_c_e_s_s_I_n_t_e_r_n_a_l_C_o_n_n_e_c_t_i_o_n function processes input
  118.        available on an internal connection.  This function should
  119.        be called for an internal connection only after an operat-
  120.        ing system facility (for example, _s_e_l_e_c_t or _p_o_l_l) has
  121.        indicated that input is available; otherwise, the effect
  122.        is not defined.
  123.  
  124.        The _X_I_n_t_e_r_n_a_l_C_o_n_n_e_c_t_i_o_n_N_u_m_b_e_r_s function returns a list of
  125.        the file descriptors for all internal connections cur-
  126.        rently open for the specified display.  When the allocated
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XAddConnectionWatch(3X11) XLIB FUNCTIONSXAddConnectionWatch(3X11)
  137.  
  138.  
  139.        list is no longer needed, free it by using _X_F_r_e_e.  This
  140.        functions returns a nonzero status if the list is success-
  141.        fully allocated; otherwise, it returns zero.
  142.  
  143. SSEEEE AALLSSOO
  144.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.