Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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			  XDEVICEBELL(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XDeviceBell&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help