XDeviceBell(3X11) X FUNCTIONS XDeviceBell(3X11)NAMEXDeviceBell - ring a bell on a device supported through
the input extension
SYNTAX
Status XDeviceBell(display, device, feedbackclass,
feedbackid, percent)
Display *display;
XDevice *device;
XID *feedbackclass;
XID *feedbackid;
int *percent;
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 XDeviceBell request causes the server to ring a bell
on the specified feedback of the specified device, if pos-
sible. The specified volume is relative to the base vol-
ume 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 XGet-
FeedbackControl request and uniquely identify the bell to
ring. If a feedbackclass is specified that does not sup-
port 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 nonnegative is:
base - [(base * percent) / 100] + percent
The volume at which the bell rings when the percent argu-
ment is negative is:
base + [(base * percent) / 100]
To change the base volume of the bell, use XChangeFeed-
backControl.
X Version 11 Release 6.4 1
XDeviceBell(3X11) X FUNCTIONS XDeviceBell(3X11)XDeviceBell can generate a BadDevice or a BadValue error.
DIAGNOSTICS
BadDevice An invalid device was specified. The speci-
fied device does not exist, or has not been
opened by this client via XOpenInputDevice.
BadValue An invalid feedbackclass, feedbackid, or per-
cent value was specified.
SEE ALSOXChangeFeedbackControl(3X), XBell(3X)
Programming With Xlib
X Version 11 Release 6.4 2