XDeviceBell(3X11)XDeviceBell(3X11)NAMEXDeviceBell - ring a bell on a device supported through the input
extension
SYNOPSIS
Status XDeviceBell(display, device, feedbackclass, feedbackid, percent)
Display *display;
XDevice *device;
XID *feedbackclass;
XID *feedbackid;
int *percent;
ARGUMENTS
Specifies the connection to the X server. Specifies the device with
which the bell is associated. Specifies the class of the feedback with
which the bell is associated. Specifies the id of the feedback with
which the bell is associated. Specifies the volume in the range -100
to 100 at which the bell should be rung.
DESCRIPTION
The XDeviceBell request causes the server to ring a bell on the speci‐
fied feedback of the specified device, if possible. The specified vol‐
ume is relative to the base volume for the bell. If an invalid device
is specified, a BadDevice error will be returned. The feedbackclass
and feedbackid parameters contain values returned by an XGetFeedback‐
Control request and uniquely identify the bell to ring. If a feedback‐
class 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 BadValue error will be returned.
The volume at which the bell is rung when the percent argument is non‐
negative is:
base - [(base * percent) / 100] + percent
The volume at which the bell rings when the percent argument is nega‐
tive is:
base + [(base * percent) / 100]
To change the base volume of the bell, use XChangeFeedbackControl.
XDeviceBell can generate a BadDevice or a BadValue error.
DIAGNOSTICS
An invalid device was specified. The specified device does not exist,
or has not been opened by this client via XOpenInputDevice. An invalid
feedbackclass, feedbackid, or percent value was specified.
SEE ALSOXChangeFeedbackControl(3X11), XBell(3X11)
Programming With Xlib
XDeviceBell(3X11)
