XDeviceBell(3X11) AIX (X FUNCTIONS) XDeviceBell(3X11) NAME XDeviceBell - ring a bell on a device supported through the input extension SYNTAX Status XDeviceBell(_d_i_s_p_l_a_y, _d_e_v_i_c_e, _f_e_e_d_b_a_c_k_c_l_a_s_s, _f_e_e_d_- _b_a_c_k_i_d, _p_e_r_c_e_n_t) Display *_d_i_s_p_l_a_y; XDevice *_d_e_v_i_c_e; XID *_f_e_e_d_b_a_c_k_c_l_a_s_s; XID *_f_e_e_d_b_a_c_k_i_d; int *_p_e_r_c_e_n_t; ARGUMENTS _d_i_s_p_l_a_y Specifies the connection to the X server. _d_e_v_i_c_e Specifies the device with which the bell is associated. _f_e_e_d_b_a_c_k_c_l_a_s_s Specifies the class of the feedback with which the bell is associated. _f_e_e_d_b_a_c_k_i_d Specifies the id of the feedback with which the bell is associated. _p_e_r_c_e_n_t Specifies the volume in the range -100 to 100 at which the bell should be rung. DESCRIPTION The _X_D_e_v_i_c_e_B_e_l_l request causes the server to ring a bell on the specified feedback of the specified device, if possible. The specified volume is relative to the base volume for the bell. If an invalid device is specified, a _B_a_d_D_e_v_i_c_e error will be returned. The feedbackclass and feedbackid parame- ters contain values returned by an _X_G_e_t_F_e_e_d_b_a_c_k_C_o_n_t_r_o_l request and uniquely identify the bell to ring. If a feed- backclass is specified that does not support a bell, or if a nonexistent feedbackid is specified, or a percent value is specified that is not in the range -100 to 100, a _B_a_d_V_a_l_u_e error will be returned. The volume at which the bell is rung when the percent argu- ment is nonnegative is: base - [(base * percent) / 100] + percent The volume at which the bell rings when the percent argument is negative is: base + [(base * percent) / 100] To change the base volume of the bell, use Rev. Release 5 Page 1 XDeviceBell(3X11) AIX (X FUNCTIONS) XDeviceBell(3X11) _X_C_h_a_n_g_e_F_e_e_d_b_a_c_k_C_o_n_t_r_o_l. _X_D_e_v_i_c_e_B_e_l_l can generate a _B_a_d_D_e_v_i_c_e or a _B_a_d_V_a_l_u_e error. DIAGNOSTICS _B_a_d_D_e_v_i_c_e An invalid device was specified. The specified device does not exist, or has not been opened by this client via _X_O_p_e_n_I_n_p_u_t_D_e_v_i_c_e. _B_a_d_V_a_l_u_e An invalid feedbackclass, feedbackid, or percent value was specified. SEE ALSO XChangeFeedbackControl(3X), XBell(3X) _P_r_o_g_r_a_m_m_i_n_g _W_i_t_h _X_l_i_b Rev. Release 5 Page 2