ISoftUSBConfiguration Interface
The ISoftUSBConfiguration is the dual interface on the SoftUSBConfiguration object. This object manages the attributes of a single configuration that is supported by a simulated USB device. Its properties are used by the SoftUSBDevice object to respond to GET_DESCRIPTOR requests from the host for the configuration descriptor.
Members
The ISoftUSBConfiguration interface inherits from the IDispatch interface. ISoftUSBConfiguration also defines the following types of members:
- Methods
- Properties
Methods
The ISoftUSBConfiguration interface defines the following methods.
| Method | Description |
|---|---|
| get_Length | Returns the bLength field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
| put_Length | Returns the bLength field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
| get_DescriptorType | Returns the bDescriptorType field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
| put_DescriptorType | Returns the bDescriptorType field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
| get_TotalLength | Returns the wTotalLength field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
| get_NumInterfaces | Returns the bNumInterfaces field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. Value is taken from SoftUSBConfiguration.Interfaces.Count. |
| get_ConfigurationValue | Returns the bConfigurationValue field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
| put_ConfigurationValue | Returns the bConfigurationValue field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
| get_Configuration | Returns the iConfiguration field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
| put_Configuration | Returns the iConfiguration field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
| get_Attributes | Returns the bmAttributes field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
| put_Attributes | Returns the bmAttributes field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
| get_MaxPower | Returns the bMaxPower field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
| put_MaxPower | Returns the bMaxPower field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
| get_Interfaces | Returns the collection of SoftUSBInterface objects that represent the set of interfaces supported by the configuration. |
| get_AlternateForInterface | Returns the SoftUSBInterface object that represents the currently selected alternate for the specified interface number. This property is used to determine the response data returned from a GET_INTERFACE request sent to the device as described in section 9.4.4 of the USB 2.0 specification. |
| get_DeviceSpecificDescriptor | Returns raw descriptor data that is appended to the standard configuration descriptor when it is sent to the host. These bytes will be inserted between the configuration descriptor and the first interface descriptor. Uses SAFEARRAY of VARIANT in which each VARIANT contains an integer between 0 and 255. |
| put_DeviceSpecificDescriptor | Returns raw descriptor data that is appended to the standard configuration descriptor when it is sent to the host. These bytes will be inserted between the configuration descriptor and the first interface descriptor. Uses SAFEARRAY of VARIANT in which each VARIANT contains an integer between 0 and 255. |
| get_Context | Returns a property bag which contains the context for the configuration. |
Properties
The ISoftUSBConfiguration interface defines the following properties. The preceding table includes access methods for these properties.
| Property | Access type | Description |
|---|---|---|
| Read-only | Returns the SoftUSBInterface object that represents the currently selected alternate for the specified interface number. This property is used to determine the response data returned from a GET_INTERFACE request sent to the device as described in section 9.4.4 of the USB 2.0 specification. |
|
| Read/write | Returns the bmAttributes field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
|
| Read/write | Returns the iConfiguration field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
|
| Read/write | Returns the bConfigurationValue field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
|
| Read-only | Returns a property bag which contains the context for the configuration. |
|
| Read/write | Returns the bDescriptorType field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
|
| Read/write | Returns raw descriptor data that is appended to the standard configuration descriptor when it is sent to the host. These bytes will be inserted between the configuration descriptor and the first interface descriptor. Uses SAFEARRAY of VARIANT in which each VARIANT contains an integer between 0 and 255. |
|
| Read-only | Returns the collection of SoftUSBInterface objects that represent the set of interfaces supported by the configuration. |
|
| Read/write | Returns the bLength field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
|
| Read/write | Returns the bMaxPower field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
|
| Read-only | Returns the bNumInterfaces field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. Value is taken from SoftUSBConfiguration.Interfaces.Count. |
|
| Read-only | Returns the wTotalLength field of the configuration descriptor as described in section 9.6.3 of the USB 2.0 specification. |
Remarks
Requirements
Header |
SoftUSBif.h |
Send comments about this topic to Microsoft
Build date: 9/21/2010