XDeviceBell

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



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

SYNTAX
       Status XDeviceBell(Display *display, XDevice *device,  XID  *feedback-
	      class, 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 speci-
       fied  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 feed-
       backclass 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 non-
       negative is:

	      base - [(base * percent) / 100] + percent

       The volume at which the bell rings when the percent argument is	nega-
       tive 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(3X), XBell(3X)
       Programming With Xlib



							    XDeviceBell(3X11)