public enum USBDeviceState extends java.lang.Enum<USBDeviceState>
IHost.getUSBDeviceFilters()
) are activated. They can
either ignore the device, or put it to USBDeviceState_Held state, or do
nothing. Unless the device is ignored by global filters, filters of all
currently running guests (IUSBDeviceFilters.getDeviceFilters()
) are
activated that can put it to USBDeviceState_Captured state.
If the device was ignored by global filters, or didn't match
any filters at all (including guest ones), it is handled by the host
in a normal way. In this case, the device state is determined by
the host and can be one of USBDeviceState_Unavailable, USBDeviceState_Busy
or USBDeviceState_Available, depending on the current device usage.
Besides auto-capturing based on filters, the device can be manually
captured by guests (IConsole.attachUSBDevice(String,String)
) if its
state is USBDeviceState_Busy, USBDeviceState_Available or
USBDeviceState_Held.
NOTE: Due to differences in USB stack implementations in Linux and Win32,
states USBDeviceState_Busy and USBDeviceState_Unavailable are applicable
only to the Linux version of the product. This also means that (IConsole.attachUSBDevice(String,String)
) can only succeed on Win32 if the
device state is USBDeviceState_Held.Enum Constant and Description |
---|
Available
Not used by the host computer, available to guests (the host computer
can also start using the device at any time).
|
Busy
Being used by the host computer, potentially available to guests.
|
Captured
Captured by one of the guest computers, not available
to anybody else.
|
Held
Held by the VirtualBox server (ignored by the host computer),
available to guests.
|
NotSupported
Not supported by the VirtualBox server, not available to guests.
|
Unavailable
Being used by the host computer exclusively,
not available to guests.
|
Modifier and Type | Method and Description |
---|---|
static USBDeviceState |
fromValue(long v) |
static USBDeviceState |
fromValue(java.lang.String v) |
int |
value() |
static USBDeviceState |
valueOf(java.lang.String name)
Returns the enum constant of this type with the specified name.
|
static USBDeviceState[] |
values()
Returns an array containing the constants of this enum type, in
the order they are declared.
|
public static final USBDeviceState NotSupported
public static final USBDeviceState Unavailable
public static final USBDeviceState Busy
public static final USBDeviceState Available
public static final USBDeviceState Held
public static final USBDeviceState Captured
public static USBDeviceState[] values()
for (USBDeviceState c : USBDeviceState.values()) System.out.println(c);
public static USBDeviceState valueOf(java.lang.String name)
name
- the name of the enum constant to be returned.java.lang.IllegalArgumentException
- if this enum type has no constant with the specified namejava.lang.NullPointerException
- if the argument is nullpublic int value()
public static USBDeviceState fromValue(long v)
public static USBDeviceState fromValue(java.lang.String v)