public class IUSBDeviceFilters extends IUnknown
Constructor and Description |
---|
IUSBDeviceFilters(java.lang.String wrapped,
org.virtualbox_6_0.ObjectRefManager objMgr,
org.virtualbox_6_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_6_0.ObjectRefManager objMgr, org.virtualbox_6_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_6_0.IUSBDeviceFilter)
.name
- Filter name. SeeIUSBDeviceFilter.getName()
for more info.VBOX_E_INVALID_VM_STATE | The virtual machine is not mutable. |
getDeviceFilters()
public void insertDeviceFilter(java.lang.Long position, IUSBDeviceFilter filter)
position
- Position to insert the filter to.filter
- USB device filter to insert.
Expected result codes:
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. |
getDeviceFilters()
public IUSBDeviceFilter removeDeviceFilter(java.lang.Long position)
position
- Position to remove the filter from.VBOX_E_INVALID_VM_STATE | Virtual machine is not mutable. |
E_INVALIDARG | USB device filter list empty or invalid position. |
getDeviceFilters()