NAME
XDeviceBell - ring a bell on a device supported through the input extension
SYNTAX
Status XDeviceBell(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
-
display
-
Specifies the connection to the X server.
-
device
-
Specifies the device with which the bell is associated.
-
feedbackclass
-
Specifies the class of the feedback with which the bell is associated.
-
feedbackid
-
Specifies the id of the feedback with which the bell is associated.
-
percent
-
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
parameters 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 feedbackclass 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 argument 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 _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(3),
XBell(3)
_P_r_o_g_r_a_m_m_i_n_g _W_i_t_h _X_l_i_b