1XDeviceBell(3) X FUNCTIONS XDeviceBell(3)
2
3
4
6 XDeviceBell - ring a bell on a device supported through the input
7 extension
8
10 Status XDeviceBell(Display *display, XDevice *device, XID *feedback‐
11 class, XID *feedbackid, int *percent);
12
14 display Specifies the connection to the X server.
15
16 device Specifies the device with which the bell is associated.
17
18 feedbackclass
19 Specifies the class of the feedback with which the bell is
20 associated.
21
22 feedbackid Specifies the id of the feedback with which the bell is
23 associated.
24
25 percent Specifies the volume in the range -100 to 100 at which the
26 bell should be rung.
27
29 The XDeviceBell request causes the server to ring a bell on the speci‐
30 fied feedback of the specified device, if possible. The specified vol‐
31 ume is relative to the base volume for the bell. If an invalid device
32 is specified, a BadDevice error will be returned. The feedbackclass
33 and feedbackid parameters contain values returned by an XGetFeedback‐
34 Control request and uniquely identify the bell to ring. If a feedback‐
35 class is specified that does not support a bell, or if a nonexistent
36 feedbackid is specified, or a percent value is specified that is not in
37 the range -100 to 100, a BadValue error will be returned.
38
39 The volume at which the bell is rung when the percent argument is non‐
40 negative is:
41
42 base - [(base * percent) / 100] + percent
43
44 The volume at which the bell rings when the percent argument is nega‐
45 tive is:
46
47 base + [(base * percent) / 100]
48
49 To change the base volume of the bell, use XChangeFeedbackControl.
50
51 XDeviceBell can generate a BadDevice or a BadValue error.
52
54 BadDevice An invalid device was specified. The specified device does
55 not exist, or has not been opened by this client via XOpen‐
56 InputDevice.
57
58 BadValue An invalid feedbackclass, feedbackid, or percent value was
59 specified.
60
62 XChangeFeedbackControl(3), XBell(3)
63 Programming With Xlib
64
65
66
67X Version 11 libXi 1.1.1 XDeviceBell(3)