|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.virtualbox_6_1.IUnknown
org.virtualbox_6_1.IUSBDeviceFilter
public class IUSBDeviceFilter
The IUSBDeviceFilter interface represents an USB device filter used to perform actions on a group of USB devices. This type of filters is used by running virtual machines to automatically capture selected USB devices once they are physically attached to the host computer. A USB device is matched to the given device filter if and only if all attributes of the device match the corresponding attributes of the filter (that is, attributes are joined together using the logical AND operation). On the other hand, all together, filters in the list of filters carry the semantics of the logical OR operation. So if it is desirable to create a match like "this vendor id OR this product id", one needs to create two filters and specify "any match" (see below) for unused attributes. All filter attributes used for matching are strings. Each string is an expression representing a set of values of the corresponding device attribute, that will match the given filter. Currently, the following filtering expressions are supported:
getManufacturer()
,getProduct()
,getSerialNumber()
) are ignored, so they behave asany matchno matter what string expression is specified.
IUSBDeviceFilters.getDeviceFilters()
,
Interface ID: {45587218-4289-EF4E-8E6A-E5B07816B631}
Field Summary |
---|
Fields inherited from class org.virtualbox_6_1.IUnknown |
---|
obj, objMgr, port |
Constructor Summary | |
---|---|
IUSBDeviceFilter(java.lang.String wrapped,
org.virtualbox_6_1.ObjectRefManager objMgr,
org.virtualbox_6_1.jaxws.VboxPortType port)
|
Method Summary | |
---|---|
java.lang.Boolean |
getActive()
Whether this filter active or has been temporarily disabled. |
java.lang.String |
getManufacturer()
IUSBDevice.getManufacturer() filter. |
java.lang.Long |
getMaskedInterfaces()
This is an advanced option for hiding one or more USB interfaces from the guest. |
java.lang.String |
getName()
Visible name for this filter. |
java.lang.String |
getPort()
IUSBDevice.getPort() filter. |
java.lang.String |
getProduct()
IUSBDevice.getProduct() filter. |
java.lang.String |
getProductId()
IUSBDevice.getProductId() filter. |
java.lang.String |
getRemote()
IUSBDevice.getRemote() filter. |
java.lang.String |
getRevision()
IUSBDevice.getProductId() filter. |
java.lang.String |
getSerialNumber()
IUSBDevice.getSerialNumber() filter. |
java.lang.String |
getVendorId()
IUSBDevice.getVendorId() filter. |
static IUSBDeviceFilter |
queryInterface(IUnknown obj)
|
void |
setActive(java.lang.Boolean value)
Whether this filter active or has been temporarily disabled. |
void |
setManufacturer(java.lang.String value)
IUSBDevice.getManufacturer() filter. |
void |
setMaskedInterfaces(java.lang.Long value)
This is an advanced option for hiding one or more USB interfaces from the guest. |
void |
setName(java.lang.String value)
Visible name for this filter. |
void |
setPort(java.lang.String value)
IUSBDevice.getPort() filter. |
void |
setProduct(java.lang.String value)
IUSBDevice.getProduct() filter. |
void |
setProductId(java.lang.String value)
IUSBDevice.getProductId() filter. |
void |
setRemote(java.lang.String value)
IUSBDevice.getRemote() filter. |
void |
setRevision(java.lang.String value)
IUSBDevice.getProductId() filter. |
void |
setSerialNumber(java.lang.String value)
IUSBDevice.getSerialNumber() filter. |
void |
setVendorId(java.lang.String value)
IUSBDevice.getVendorId() filter. |
Methods inherited from class org.virtualbox_6_1.IUnknown |
---|
getObjMgr, getRemoteWSPort, getWrapped, releaseRemote |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public IUSBDeviceFilter(java.lang.String wrapped, org.virtualbox_6_1.ObjectRefManager objMgr, org.virtualbox_6_1.jaxws.VboxPortType port)
Method Detail |
---|
public java.lang.String getName()
public void setName(java.lang.String value)
value
- Stringpublic java.lang.Boolean getActive()
public void setActive(java.lang.Boolean value)
value
- Booleanpublic java.lang.String getVendorId()
IUSBDevice.getVendorId()
filter.
The string representation for theexact matchinghas the formXXXX, whereXis the hex digit
(including leading zeroes).
public void setVendorId(java.lang.String value)
IUSBDevice.getVendorId()
filter.
The string representation for theexact matchinghas the formXXXX, whereXis the hex digit
(including leading zeroes).
value
- Stringpublic java.lang.String getProductId()
IUSBDevice.getProductId()
filter.
The string representation for theexact matchinghas the formXXXX, whereXis the hex digit
(including leading zeroes).
public void setProductId(java.lang.String value)
IUSBDevice.getProductId()
filter.
The string representation for theexact matchinghas the formXXXX, whereXis the hex digit
(including leading zeroes).
value
- Stringpublic java.lang.String getRevision()
IUSBDevice.getProductId()
filter. The string representation for theexact matchinghas the formIIFF, whereIis the decimal digit
of the integer part of the revision, andFis the
decimal digit of its fractional part (including leading and
trailing zeros).
Note that for interval filters, it's best to use the hexadecimal
form, because the revision is stored as a 16 bit packed BCD value;
so the expressionint:0x0100-0x0199will match any
revision from1.0to1.99.
public void setRevision(java.lang.String value)
IUSBDevice.getProductId()
filter. The string representation for theexact matchinghas the formIIFF, whereIis the decimal digit
of the integer part of the revision, andFis the
decimal digit of its fractional part (including leading and
trailing zeros).
Note that for interval filters, it's best to use the hexadecimal
form, because the revision is stored as a 16 bit packed BCD value;
so the expressionint:0x0100-0x0199will match any
revision from1.0to1.99.
value
- Stringpublic java.lang.String getManufacturer()
IUSBDevice.getManufacturer()
filter.
public void setManufacturer(java.lang.String value)
IUSBDevice.getManufacturer()
filter.
value
- Stringpublic java.lang.String getProduct()
IUSBDevice.getProduct()
filter.
public void setProduct(java.lang.String value)
IUSBDevice.getProduct()
filter.
value
- Stringpublic java.lang.String getSerialNumber()
IUSBDevice.getSerialNumber()
filter.
public void setSerialNumber(java.lang.String value)
IUSBDevice.getSerialNumber()
filter.
value
- Stringpublic java.lang.String getPort()
IUSBDevice.getPort()
filter.
public void setPort(java.lang.String value)
IUSBDevice.getPort()
filter.
value
- Stringpublic java.lang.String getRemote()
IUSBDevice.getRemote()
filter.
NOTE: This filter makes sense only for machine USB filters,
i.e. it is ignored by IHostUSBDeviceFilter objects.
public void setRemote(java.lang.String value)
IUSBDevice.getRemote()
filter.
NOTE: This filter makes sense only for machine USB filters,
i.e. it is ignored by IHostUSBDeviceFilter objects.
value
- Stringpublic java.lang.Long getMaskedInterfaces()
public void setMaskedInterfaces(java.lang.Long value)
value
- Longpublic static IUSBDeviceFilter queryInterface(IUnknown obj)
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |