DMXAddInput(3X) UNIX Programmer's Manual DMXAddInput(3X)
NAME
DMXAddInput, DMXAddBackendInput, DMXAddConsoleInput - attach
a new input
SYNOPSIS
#include <X11/extensions/dmxext.h>
Bool DMXAddInput(Display *dpy,
unsigned int mask,
DMXInputAttributes *attr,
int *id);
Bool DMXAddBackendInput(Display *dpy,
int screen,
int sendsCore,
int *newId);
Bool DMXAddConsoleInput(Display *dpy,
const char *name,
int sendsCore,
int *newId);
DESCRIPTION
DMXAddInput() is used to attach a new input (or a previously
detached input) to the Xdmx(1) server. mask specifies the
fields in attr that are active, and id returns the device if
of the first device in the series that is added.
The value of mask is computed from the following values:
DMXInputType
DMXInputPhysicalScreen
DMXInputSendsCore
The DMXInputAttributes structure is:
typedef struct {
DMXInputEnum inputType;
int physicalScreen;
int physicalId;
Bool isCore;
Bool sendsCore;
const char *name;
Bool detached;
} DMXInputAttributes;
inputType may bave the value DmxConsoleInputType or
DmxBackendInputType .
For console devices, name will specify the display to be
used.
For back-end devices, physicalScreen will specify the
Xdmx(1) screen number.
XFree86 Version 4.5.0 1
DMXAddInput(3X) UNIX Programmer's Manual DMXAddInput(3X)
If sendsCore is True, the new device will be added as a true
core device.
If a device was removed with DMXRemoveInput(3X) an attempt
will be made to reconnect the previous devices (sendsCore is
ignored in this case).
DMXAddBackendInput() is a helper function that is used to
add input from a back-end server. With this function, screen
refers to the back-end screen, sendsCore is True if the new
input should send core events (and it ignored if the input
has been detached), and newId will hold the device id of the
first device in the series added.
DMXAddConsoleInput() is a helper function that is used to
add input from a console. With this function, name is the
name of the console display, sendsCore is True if the new
input should send core events (and it ignored if the input
has been detached), and newId will hold the device id of the
first device in the series added.
RETURN VALUE
DMXAddInput() returns True on success and False otherwise.
DMXAddInput() can generate BadValue (if inputType is invalid
or physicalScreen is out of range), BadAccess (if the input
has already been attached or if the backend screen is
currently detached).
NOTES
Local devices cannot be attached or detached.
Attributes that are not specified will default to 0. This
may lead to unintended results.
SEE ALSO
DMXRemoveInput(3X), DMX(3X), Xdmx(1)
XFree86 Version 4.5.0 2