XDEVICEBELL(3) |  | XDEVICEBELL(3)

# NAME

XDeviceBell - ring a bell on a device supported through the input extension

# SYNOPSIS

    #include <X11/extensions/XInput.h>

    Status XDeviceBell( Display *display,

                        XDevice *device,

                        XID feedbackclass,

                        XID feedbackid,

                        int percent);
    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.

    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(3), XBell(3)

05/18/2026 |