public class IUSBDeviceFilters extends IUnknown
Constructor and Description |
---|
IUSBDeviceFilters(java.lang.String wrapped,
org.virtualbox_7_0.ObjectRefManager objMgr,
org.virtualbox_7_0.jaxws.VboxPortType port) |
Modifier and Type | Method and Description |
---|---|
IUSBDeviceFilter |
createDeviceFilter(java.lang.String name)
Creates a new USB device filter.
|
java.util.List<IUSBDeviceFilter> |
getDeviceFilters()
List of USB device filters associated with the machine.
|
void |
insertDeviceFilter(java.lang.Long position,
IUSBDeviceFilter filter)
Inserts the given USB device to the specified position
in the list of filters.
|
static IUSBDeviceFilters |
queryInterface(IUnknown obj) |
IUSBDeviceFilter |
removeDeviceFilter(java.lang.Long position)
Removes a USB device filter from the specified position in the
list of filters.
|
getObjMgr, getRemoteWSPort, getWrapped, releaseRemote
public IUSBDeviceFilters(java.lang.String wrapped, org.virtualbox_7_0.ObjectRefManager objMgr, org.virtualbox_7_0.jaxws.VboxPortType port)
public java.util.List<IUSBDeviceFilter> getDeviceFilters()
IHost.getUSBDeviceFilters()
).
These filters are also activated when the machine is powered up.
They are run against a list of all currently available USB
devices (in statesUSBDeviceState.Available
,USBDeviceState.Busy
,USBDeviceState.Held
) that were not previously
ignored by global filters.
If at least one filter matches the USB device in question, this
device is automatically captured (attached to) the virtual USB
controller of this machine.IUSBDeviceFilter
,
IUSBController
public static IUSBDeviceFilters queryInterface(IUnknown obj)
public IUSBDeviceFilter createDeviceFilter(java.lang.String name)
insertDeviceFilter(Long,org.virtualbox_7_0.IUSBDeviceFilter)
.
VBOX_E_INVALID_VM_STATE
- The virtual machine is not mutable.name
- Filter name. SeeIUSBDeviceFilter.getName()
for more info.getDeviceFilters()
public void insertDeviceFilter(java.lang.Long position, IUSBDeviceFilter filter)
0
. If the specified
position is equal to or greater than the number of elements in
the list, the filter is added to the end of the collection.
VBOX_E_INVALID_VM_STATE
- Virtual machine is not mutable.E_INVALIDARG
- USB device filter not created within this VirtualBox instance.VBOX_E_INVALID_OBJECT_STATE
- USB device filter already in list.position
- Position to insert the filter to.filter
- USB device filter to insert.
NOTE: Duplicates are not allowed, so an attempt to insert a
filter that is already in the collection, will return an
error.getDeviceFilters()
public IUSBDeviceFilter removeDeviceFilter(java.lang.Long position)
0
. Specifying a
position equal to or greater than the number of elements in
the list will produce an error.
VBOX_E_INVALID_VM_STATE
- Virtual machine is not mutable.E_INVALIDARG
- USB device filter list empty or invalid position.position
- Position to remove the filter from.getDeviceFilters()