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(3X), XBell(3X)
_P_r_o_g_r_a_m_m_i_n_g _W_i_t_h _X_l_i_b