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]

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





10/89                                                                    Page 1

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


      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









































Page 2                                                                    10/89