<HTML>
<HEAD>
<TITLE></TITLE>
</HEAD>
<BODY>
<PRE>



XDeviceBell(3X11)	   X FUNCTIONS		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.



X Version 11		   Release 6.1				1





XDeviceBell(3X11)	   X FUNCTIONS		XDeviceBell(3X11)


       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












































X Version 11		   Release 6.1				2


</PRE>
</BODY>
</HTML>
