UsbDevice class

Represents a USB device. The object provides methods and properties that an app can use to find the device (in the system) with which the app wants to communicate, and sends IN and OUT control transfers to the device.

Syntax

var usbDevice = Windows.Devices.Usb.UsbDevice;

Attributes

[DualApiPartition()]

[MarshalingBehavior(Agile)]

[Version(0x06030000)]

Members

The UsbDevice class has these types of members:

• Methods
• Properties

Methods

The UsbDevice class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

Properties

The UsbDevice class has these properties.

Remarks

Before getting a reference to the UsbDevice object, you must have one of these identifiers:

• The vendor and product identifiers for the physical device. Those identifiers are part of the hardware ID string. You can obtain that string from the Models section in the INF file. Alternatively, if WinUSB was loaded based on the compatible ID specified in the device descriptor, you can derive the identifiers from the Hardware Ids property in Device Manager. For example, if Hardware Id is "USB\VID_045E&PID_078E", vendor ID is "0x045E" and product Id is "0x078E".
• The device interface GUID. You can obtain that GUID from the DeviceInterfaceGuids registry entry under this key:

  HKEY_LOCAL_MACHINE\System\CurrentControlSet\Enum\USB\<Device Identifier>\<Instance Identifier>\Device Parameters

• The device's class, subclass, and protocol codes. You can obtain that information from the CompatibleIds registry entry, found under the Device Parameters key.

To get the UsbDevice object:

1. Get the Advanced Query Syntax (AQS) string that contains search criteria for finding the device in the enumerated device collection. If you want to search by the vendor ID/product ID or the device interface GUID, call GetDeviceSelector. If you want to search by the device class, call GetDeviceClassSelector. Both calls retrieve formatted AQS strings.
2. Pass the retrieved string to FindAllAsync. The call retrieves a DeviceInformationCollection object.
3. Loop through the collection. Each iteration gets a DeviceInformation object.
4. Get the DeviceInformation.Id property value. The string value is the device instance path. For example, "\\\\?\\USB#VID_045E&PID_078F#6&1b8ff026&0&5#{dee824ef-729b-4a0e-9c14-b7117d33a817}".
5. Call FromIdAsync by passing the device instance string and get the UsbDevice object.

You can then use the UsbDevice object to perform other operations, such as sending a control transfer. When the app has finished using the UsbDevice object, the app must release it by calling Close.

Examples

This example code shows how to get the UsbDevice object by specifying the vendor/product Id or the device interface GUID.

protected override async void OnLaunched1(LaunchActivatedEventArgs args)
{
    UInt32 vid = 0x045E;
    UInt32 pid = 0x078F;

    string aqs = UsbDevice.GetDeviceSelector(vid, pid);
    
    var myDevices = await Windows.Devices.Enumeration.DeviceInformation.FindAllAsync(aqs, null);
            
    if (myDevices.Count == 0)
    {
        ShowError("Device not found!");
        return;
    }

    UsbDevice device = await UsbDevice.FromIdAsync(myDevices[0].Id);

   // Send a control transfer. 
            
   UsbSetupPacket initSetupPacket = new UsbSetupPacket() 
   { 
       Request = initRequest,
       RequestType = new UsbControlRequestType() { 

           Recipient = UsbControlRecipient.DefaultInterface,
                                                            
           ControlTransferType = UsbControlTransferType.Vendor 
       } 
   };
            
   await device.SendOutControlTransferAsync(initSetupPacket);

}

Requirements

See also

Object

IClosable