XDeviceBell(3X11)

NAME
       XDeviceBell  -  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.

       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 ALSO
       XChangeFeedbackControl(3X) XBell(3X) 
       Programming With Xlib