![]() |
![]() |
![]() |
Spice-GTK Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals |
#include <usb-device-manager.h> #define SPICE_TYPE_USB_DEVICE struct SpiceUsbDeviceManager; struct SpiceUsbDeviceManagerClass; SpiceUsbDeviceManager * spice_usb_device_manager_get (SpiceSession *session
,GError **err
); GPtrArray * spice_usb_device_manager_get_devices (SpiceUsbDeviceManager *manager
); GPtrArray * spice_usb_device_manager_get_devices_with_filter (SpiceUsbDeviceManager *manager
,const gchar *filter
); gboolean spice_usb_device_manager_is_device_connected (SpiceUsbDeviceManager *manager
,SpiceUsbDevice *device
); void spice_usb_device_manager_disconnect_device (SpiceUsbDeviceManager *manager
,SpiceUsbDevice *device
); gboolean spice_usb_device_manager_can_redirect_device (SpiceUsbDeviceManager *self
,SpiceUsbDevice *device
,GError **err
); void spice_usb_device_manager_connect_device_async (SpiceUsbDeviceManager *manager
,SpiceUsbDevice *device
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
); gboolean spice_usb_device_manager_connect_device_finish (SpiceUsbDeviceManager *self
,GAsyncResult *res
,GError **err
); SpiceUsbDevice; gchar * spice_usb_device_get_description (SpiceUsbDevice *device
,const gchar *format
);
"auto-connect" gboolean : Read / Write "auto-connect-filter" gchar* : Read / Write / Construct "redirect-on-connect" gchar* : Read / Write "session" SpiceSession* : Read / Write / Construct Only
"auto-connect-failed" :Run First
"device-added" :Run First
"device-error" :Run First
"device-removed" :Run First
SpiceUsbDeviceManager monitors USB redirection channels and USB
devices plugging/unplugging. If "auto-connect"
is set to TRUE
, it will automatically connect newly plugged USB
devices to available channels.
There should always be a 1:1 relation between SpiceUsbDeviceManager objects
and SpiceSession objects. Therefor there is no
spice_usb_device_manager_new, instead there is
spice_usb_device_manager_get()
which ensures this 1:1 relation.
struct SpiceUsbDeviceManager;
The SpiceUsbDeviceManager struct is opaque and should not be accessed directly.
struct SpiceUsbDeviceManagerClass { GObjectClass parent_class; /* signals */ void (*device_added) (SpiceUsbDeviceManager *manager, SpiceUsbDevice *device); void (*device_removed) (SpiceUsbDeviceManager *manager, SpiceUsbDevice *device); void (*auto_connect_failed) (SpiceUsbDeviceManager *manager, SpiceUsbDevice *device, GError *error); void (*device_error) (SpiceUsbDeviceManager *manager, SpiceUsbDevice *device, GError *error); };
Class structure for SpiceUsbDeviceManager.
Parent class. | |
Signal class handler for the "device-added" signal. | |
Signal class handler for the "device-removed" signal. | |
Signal class handler for the "auto-connect-failed" signal. | |
SpiceUsbDeviceManager * spice_usb_device_manager_get (SpiceSession *session
,GError **err
);
Gets the SpiceUsbDeviceManager associated with the passed in SpiceSession. A new SpiceUsbDeviceManager instance will be created the first time this function is called for a certain SpiceSession.
Note that this function returns a weak reference, which should not be used after the SpiceSession itself has been unref-ed by the caller.
|
SpiceSession for which to get the SpiceUsbDeviceManager |
Returns : |
a weak reference to the SpiceUsbDeviceManager associated with the passed in SpiceSession. [transfer none] |
GPtrArray * spice_usb_device_manager_get_devices
(SpiceUsbDeviceManager *manager
);
|
the SpiceUsbDeviceManager manager |
Returns : |
a GPtrArray array of SpiceUsbDevice . [element-type SpiceUsbDevice][transfer full]
|
GPtrArray * spice_usb_device_manager_get_devices_with_filter (SpiceUsbDeviceManager *manager
,const gchar *filter
);
|
the SpiceUsbDeviceManager manager |
|
filter string for selecting which devices to return, see "auto-connect-filter" for the filter string format |
Returns : |
a
GPtrArray array of SpiceUsbDevice . [element-type SpiceUsbDevice][transfer full]
|
Since 0.20
gboolean spice_usb_device_manager_is_device_connected (SpiceUsbDeviceManager *manager
,SpiceUsbDevice *device
);
|
the SpiceUsbDeviceManager manager |
|
a SpiceUsbDevice |
Returns : |
TRUE if device has an associated USB redirection channel |
void spice_usb_device_manager_disconnect_device (SpiceUsbDeviceManager *manager
,SpiceUsbDevice *device
);
|
the SpiceUsbDeviceManager manager |
|
a SpiceUsbDevice to disconnect |
Returns : |
TRUE if device has an associated USB redirection channel |
gboolean spice_usb_device_manager_can_redirect_device (SpiceUsbDeviceManager *self
,SpiceUsbDevice *device
,GError **err
);
void spice_usb_device_manager_connect_device_async (SpiceUsbDeviceManager *manager
,SpiceUsbDevice *device
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
|
the SpiceUsbDeviceManager manager |
|
a SpiceUsbDevice to redirect |
|
a GCancellable or NULL |
|
a GAsyncReadyCallback to call when the request is satisfied |
|
data to pass to callback |
gboolean spice_usb_device_manager_connect_device_finish (SpiceUsbDeviceManager *self
,GAsyncResult *res
,GError **err
);
gchar * spice_usb_device_get_description (SpiceUsbDevice *device
,const gchar *format
);
Get a string describing the device which is suitable as a description of
the device for the end user. The returned string should be freed with
g_free()
when no longer needed.
The format
positional parameters are the following:
'%1
$s' manufacturer
'%2
$s' product
'%3
$s' descriptor (a [vendor_id:product_id] string)
'%4
$d' bus
'%5
$d' address
(the default format string is "%s
%s
%s
at %d
-%d
")
|
SpiceUsbDevice to get the description of |
|
an optionnal printf() format string with positional parameters |
Returns : |
a newly-allocated string holding the description, or NULL if failed |
"auto-connect"
property "auto-connect" gboolean : Read / Write
Set this to TRUE to automatically redirect newly plugged in device.
Note when SpiceGtkSession's auto-usbredir property is TRUE, this property is controlled by SpiceGtkSession.
Default value: FALSE
"auto-connect-filter"
property "auto-connect-filter" gchar* : Read / Write / Construct
Set a string specifying a filter to use to determine which USB devices to autoconnect when plugged in, a filter consists of one or more rules. Where each rule has the form of:
class
,vendor
,product
,version
,allow
Use -1 for class
/vendor
/product
/version
to accept any value.
And the rules are themselves are concatonated like this:
rule1
|rule2
|rule3
The default setting filters out HID (class 0x03) USB devices from auto connect and auto connects anything else. Note the explicit allow rule at the end, this is necessary since by default all devices without a matching filter rule will not auto-connect.
Filter strings in this format can be easily created with the RHEV-M USB filter editor tool.
Default value: "0x03,-1,-1,-1,0|-1,-1,-1,-1,1"
"redirect-on-connect"
property "redirect-on-connect" gchar* : Read / Write
Set a string specifying a filter selecting USB devices to automatically redirect after a Spice connection has been established.
See "auto-connect-filter" for the filter string format.
Default value: NULL
"session"
property"session" SpiceSession* : Read / Write / Construct Only
SpiceSession this SpiceUsbDeviceManager is associated with
"auto-connect-failed"
signalvoid user_function (SpiceUsbDeviceManager *manager,
SpiceUsbDevice *device,
GError *error,
gpointer user_data) : Run First
The "auto-connect-failed" signal is emitted whenever the auto-connect property is true, and a newly plugged in device could not be auto-connected.
|
the SpiceUsbDeviceManager that emitted the signal |
|
SpiceUsbDevice boxed object corresponding to the device which failed to auto connect |
|
GError describing the reason why the autoconnect failed |
|
user data set when the signal handler was connected. |
"device-added"
signalvoid user_function (SpiceUsbDeviceManager *manager,
SpiceUsbDevice *device,
gpointer user_data) : Run First
The "device-added" signal is emitted whenever a new USB device has been plugged in.
|
the SpiceUsbDeviceManager that emitted the signal |
|
SpiceUsbDevice boxed object corresponding to the added device |
|
user data set when the signal handler was connected. |
"device-error"
signalvoid user_function (SpiceUsbDeviceManager *manager,
SpiceUsbDevice *device,
GError *error,
gpointer user_data) : Run First
The "device-error" signal is emitted whenever an error happens which causes a device to no longer be available to the guest.
|
SpiceUsbDeviceManager that emitted the signal |
|
SpiceUsbDevice boxed object corresponding to the device which has an error |
|
GError describing the error |
|
user data set when the signal handler was connected. |
"device-removed"
signalvoid user_function (SpiceUsbDeviceManager *manager,
SpiceUsbDevice *device,
gpointer user_data) : Run First
The "device-removed" signal is emitted whenever an USB device has been removed.
|
the SpiceUsbDeviceManager that emitted the signal |
|
SpiceUsbDevice boxed object corresponding to the removed device |
|
user data set when the signal handler was connected. |