ISoftUSBDevice Interface

The ISoftUSBDevice interface is implemented by the SoftUSBDevice object, which is used to represent every simulated USB device.

Members

The ISoftUSBDevice interface inherits from the IDispatch interface. ISoftUSBDevice also defines the following types of members:

  • Methods
  • Properties

Methods

The ISoftUSBDevice interface defines the following methods.

Method Description
Destroy

Destroys a SoftUSBDevice object before the last reference to the device is removed.

Resume

Forces a device into a configured state from a suspended state.

 

Properties

The ISoftUSBDevice interface defines the following properties.

Property Access type Description

Address

Read-only

Gets the device's address that the host assigned to the device.

Configuration

Read-only

Gets the number of the device's currently selected configuration. This number is the same number that the ISoftUSBConfiguration::ConfigurationValue property returns. You can use this property to determine the response data that is returned from a GET_CONFIGURATION request that is sent to the device, as described in section 9.4.2 of the USB 2.0 specification.

Configurations

Read-only

Gets the collection of ISoftUSBConfiguration objects that represent the set of configurations that the device supports.

Context

Read-only

Gets the Context object for the interface

DescriptorType

Read/write

Gets or sets the value of the bDescriptorType field of the device descriptor, as defined in section 9.6.1 of the USB 2.0 specification.

Device

Read/write

Gets or sets the device release number, which is the value of the bcdDevice field of the device descriptor as defined in section 9.6.1 of the USB 2.0 specification.

DeviceClass

Read/write

Gets or sets the value of the bDeviceClass field of the device descriptor, as defined in section 9.6.1 of the USB 2.0 specification.

DeviceProtocol

Read/write

Gets or sets the value of the bDeviceProtocol field of the device descriptor, as defined in section 9.6.1 of the USB 2.0 specification.

DeviceQualifier

Read/write

Gets or sets the ISoftUSBDeviceQualifier object that represents the Device_Qualifier descriptor for the device.

DeviceSubClass

Read/write

Returns the value of the bDeviceSubClass field of the device descriptor as defined in section 9.6.1 of the USB 2.0 specification. This property is read/write

DSFDevice

Read-only

Gets the DSFDevice object that is associated with the USB device that holds the USB device's Plug and Play (PnP) properties.

Endpoint0

Read-only

Gets the ISoftUSBEndpoint object that represents the device's control endpoint.

HasExternalPower

Read/write

Gets or sets whether the device currently has external power. This property is used only for devices that can be self-powered.

Length

Read/write

Gets or sets the value of the bLength field of the device descriptor, as defined in section 9.6.1 of the USB 2.0 specification.

Manufacturer

Read/write

Gets or sets the value of the iManufacturer field of the device descriptor, as defined in section 9.6.1 of the USB 2.0 specification.

MaxPacketSize0

Read/write

Gets or sets the value of the bMaxPacketSize0 field of the device descriptor, as defined in section 9.6.1 of the USB 2.0 specification.

NumConfigurations

Read-only

Gets the value of the bNumConfigurations field of the device descriptor, as defined in section 9.6.1 of the USB 2.0 specification. The value is taken from the Count property of the ISoftUSBDevice::Configurations collection.

OperatingSpeed

Read-only

Gets the operating speed for the device.

Product

Read/write

Gets or sets the value of the idProduct field of the device descriptor, as defined in section 9.6.1 of the USB 2.0 specification.

ProductDesc

Read/write

Gets or sets the product description, which is the value of the iProduct field of the device descriptor as defined in section 9.6.1 of the USB 2.0 specification.

RemoteWakeup

Read/write

Gets or sets whether the device supports remote wake-up. You can use this property to determine the value of the D1 bit that is returned from a GET_STATUS request that is sent to the device, as described in section 9.4.5 of the USB 2.0 specification.

SerialNumber

Read/write

Gets or sets the value of the iSerialNumber field of the device descriptor, as defined in section 9.6.1 of the USB 2.0 specification.

State

Read-only

Gets the current state for the device.

Strings

Read-only

Gets a collection of ISoftUSBString objects that represent the device's string descriptors. The string descriptor index that is specified within other descriptors (for example, in the ISoftUSBDevice::Manufacturer property) determines the index of the corresponding ISoftUSBString object in this collection.

USB

Read/write

Gets or sets the value of the bcdUSB field of the device descriptor, as defined in section 9.6.1 of the USB 2.0 specification.

USB1xConfigurations

Read-only

Gets the collection of ISoftUSBConfiguration objects that represent the other speed configurations that the device supports.

Vendor

Read/write

Gets or sets the value of the idVendor field of the device descriptor, as defined in section 9.6.1 of the USB 2.0 specification.

 

Requirements

Header

SoftUSBif.h

See Also

ISoftUSBConfiguration

ISoftUSBConfiguration::ConfigurationValue

ISoftUSBDevice::Configurations

ISoftUSBDevice::Manufacturer

ISoftUSBDeviceQualifier

ISoftUSBString

 

 

Send comments about this topic to Microsoft

Build date: 9/21/2010