VirtualBox Main API

Public Attributes | List of all members
IHostUSBDeviceFilter Interface Reference

The IHostUSBDeviceFilter interface represents a global filter for a physical USB device used by the host computer. More...

Inheritance diagram for IHostUSBDeviceFilter:

## Public Attributes
attribute USBDeviceFilterAction | action
| Action performed by the host when an attached USB device matches this filter.
Public Attributes inherited from IUSBDeviceFilter
attribute wstring | name
| Visible name for this filter.
attribute boolean | active
| Whether this filter active or has been temporarily disabled.
attribute wstring | vendorId
| Vendor ID filter.
attribute wstring | productId
| Product ID filter.
attribute wstring | revision
| Product revision number filter.
attribute wstring | manufacturer
| Manufacturer filter.
attribute wstring | product
| Product filter.
attribute wstring | serialNumber
| Serial number filter.
attribute wstring | port
| Host USB port filter.
attribute wstring | remote
| Remote state filter.
attribute unsigned long | maskedInterfaces
| This is an advanced option for hiding one or more USB interfaces from the guest.

## Detailed Description

The IHostUSBDeviceFilter interface represents a global filter for a physical USB device used by the host computer.

Used indirectly in IHost::USBDeviceFilters.

Using filters of this type, the host computer determines the initial state of the USB device after it is physically attached to the host's USB controller.

Note
  The IUSBDeviceFilter::remote attribute is ignored by this type of filters, because it makes sense only for machine USB filters.

See also
  IHost::USBDeviceFilters

Interface ID:
  `{01ADB2D6-AEDF-461C-BE2C-99E91BDAD8A1}`

## Member Data Documentation

## ◆ action

attribute USBDeviceFilterAction IHostUSBDeviceFilter::action

Action performed by the host when an attached USB device matches this filter.