XDeviceBell.3XI.z(3X11)



     XDeviceBell(3X11)   X Version 11 (Release 5)    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 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
          parameters contain values returned by an XGetFeedbackControl
          request and uniquely identify the bell to ring.  If a
          feedbackclass 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 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]




     Licensed material--property of copyright holder(s)         Page 1



     XDeviceBell(3X11)   X Version 11 (Release 5)    XDeviceBell(3X11)



          To change the base volume of the bell, use
          XChangeFeedbackControl.

          XDeviceBell can generate a BadDevice or a BadValue error.

     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







































     Licensed material--property of copyright holder(s)         Page 2

Museum