rapi_connection_from_name(3) [debian man page]
RAPI_CONNECTION_FROM_NAME(3) http://www.synce.org/ RAPI_CONNECTION_FROM_NAME(3) NAME
rapi_connection_from_name - obtain connection for RAPI function calls SYNOPSIS
#include <rapi.h> RapiConnection *rapi_connection_from_name(const char *device_name); RapiConnection *rapi_connection_from_info(SynceInfo *info); void rapi_connection_select(RapiConnection *connection); void rapi_connection_destroy(RapiConnection *connection); HRESULT CeRapiInit(); STDAPI CeRapiUninit(); DESCRIPTION
The rapi_connection_from_info() function returns a pointer to a newly allocated RapiConnection struct, used for remote function calls to a mobile device. The RapiConnection keeps a pointer to the SynceInfo struct but does not copy it, therefore freeing the SynceInfo before the RapiConnection is not recommended. rapi_connection_from_name() accomplishes the same for the connected device named device_name. Refer to synce_info_new(3) for insight on how this name and the connection daemon in use can affect the device contacted. rapi_connection_select() allows for selection between multiple active connections. NULL can be passed to result in no active connection. rapi_connection_destroy() frees a RapiConnection. This should not be called before CeRapiUninit(). CeRapiInit() connects the current RapiConnection to it's mobile device. If already initialised, CERAPI_E_ALREADYINITIALIZED is returned. CeRapiUninit() destroys the connection for the current RapiConnection. The RapiConnection cannot be re-initialised, it must be destroyed. An example of using multiple devices follows. /* * SynCE support for switching between multiple devices * * Example code for two devices follows! * * It shows two different ways to get a RapiConnection object. * */ RapiConnection* a = rapi_connection_from_name("device_a"); rapi_connection_select(a); CeRapiInit() SynceInfo* info_b = synce_info_new("device_b"); RapiConnection* b = rapi_connection_from_info(info_b); rapi_connection_select(b); CeRapiInit() rapi_connection_select(a); ...some RAPI calls to device A... rapi_connection_select(b); ...some RAPI calls to device B... rapi_connection_select(a); CeRapiUninit(); rapi_connection_destroy(a); rapi_connection_select(b); CeRapiUninit(); rapi_connection_destroy(b); synce_info_destroy(info_b); RETURN VALUE
rapi_connection_from_name() and rapi_connection_from_info() return a pointer to a new RapiConnection. CeRapiInit() and CeRapiUninit() return S_OK on success or an error code on failure. AUTHOR
This manual page was written by Mark Ellis <mark_ellis@users.sourceforge.net>. SEE ALSO
synce(7), synce_info_new(3), odccm(1), vdccm(1) The SynCE Project 2007-08-26 RAPI_CONNECTION_FROM_NAME(3)
Check Out this Related Man Page
xinput(1) General Commands Manual xinput(1) NAME
xinput - utility to configure and test XInput devices SYNOPSIS
xinput [version] [list [device_name]] [set-pointer device_name] [get-feedbacks device_name] [set-mode device_name ABSOLUTE|RELATIVE] [set- ptr-feedback device_name threshold num denom] [set-integer-feedback device_name index value] [set-button-map device_name map button 1 [map button 2 [...]]] [query-state device_name] [test [-proximity] device_name] DESCRIPTION
xinput version test if the XInput extension is available and return the version number of the program. xinput list [device_name] If no argument is given list all the input devices showing all their features. If an argument is given, show all the feature of device_name. Uses XListInputDevices(3). xinput get-feedbacks device_name Display the feedbacks of device_name. Uses XGetFeedbackControl(3). xinput set-pointer device_name Switch device_name in core pointer. Uses XChangePointerDevice(3). xinput set-mode device_name ABSOLUTE|RELATIVE Change the mode of device_name. Uses XSetDeviceMode(3). xinput set-ptr-feedback device_name threshold num denom Change the acceleration of device_name. Uses XChangeFeedbackControl(3). xinput set-integer-feedback device_name index value Change the value of an integer feedback of device_name. Uses XChangeFeedbackControl(3). xinput set-button-map device_name map button 1 [map button 2 [...]] Change the button mapping of device_name. Uses XSetDeviceButtonMapping(3). xinput query-state device_name Query the device state. Uses XQueryDeviceState(3). xinput list-props device_name [device_name...] Lists properties that can be set for the given device(s). xinput set-int-prop device_name property format value Sets an integer property for the device. Appropriate values for format are 8, 16, or 32, depending on the property. xinput watch-props device_name Prints to standard out when property changes occur. xinput delete-prop device_name property Delete the property from the device. xinput test [-proximity] device_name Register all extended events from device_name and enter an endless loop displaying events received. If the -proximity is given, ProximityIn and ProximityOut are registered. device_name can be the device name as a string or the XID of the device. property can be the property as a string or the Atom value. COPYRIGHT
Copyright 1996,1997, Frederic Lepied. Copyright 2008, Philip Langdale. AUTHOR
Philip Langdale, <philipl@alumni.utexas.net> Frederic Lepied, France <Frederic.Lepied@sugix.frmug.org> Patches, bug reports, and suggestions are welcome. Frederic Lepied $Date: 1997/06/09 16:06:31 $ xinput(1)