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)

								    03/09/2013							    XDEVICEBELL(3)