XDeviceBell(3X11) X FUNCTIONS XDeviceBell(3X11)
NAME
XDeviceBell - ring a bell on a device supported through the
input extension
SYNTAX
Status XDeviceBell(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 possible.
The specified volume 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 parame-
ters contain values returned by an XGetFeedbackControl
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 BadValue
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 XChangeFeed-
backControl.
XDeviceBell can generate a BadDevice or a BadValue error.
XFree86 Version 4.5.0 1
XDeviceBell(3X11) X FUNCTIONS XDeviceBell(3X11)
DIAGNOSTICS
BadDevice An invalid device was specified. The specified
device does not exist, or has not been opened by
this client via XOpenInputDevice.
BadValue An invalid feedbackclass, feedbackid, or percent
value was specified.
SEE ALSO
XChangeFeedbackControl(3X), XBell(3X)
Programming With Xlib
XFree86 Version 4.5.0 2