获取USB设备的产品字符串(C#/C++)

Get product string of USB device (C#/C++)

本文关键字:C++ 字符串 USB 获取      更新时间:2023-10-16

如何从C#或C++上的USB设备描述符(设备不是硬盘,而是耳机等外部设备)中获取产品字符串?我需要"我的耳机"串。

      ======================== USB Device ========================
        +++++++++++++++++ Device Information ++++++++++++++++++
Device Description       : USB Composite Device
Device Path              : \?usb#vid_2ae2&pid_1388#abcdef0123456789#{a5dcbf10-6530-11d2-901f-00c04fb951ed}
Device ID                : USBVID_2AE2&PID_1388ABCDEF0123456789
Driver KeyName           : {36fc9e60-c465-11cf-8056-444553540000}018 (GUID_DEVCLASS_USB)
Driver                   : C:WindowsSystem32driversusbccgp.sys (Version: 6.3.9600.17238  Date: 2014-07-24)
Driver Inf               : C:Windowsinfusb.inf
Legacy BusType           : PNPBus
Class                    : USB
Service                  : usbccgp
Enumerator               : USB
Location Info            : Port_#0006.Hub_#0003
Location IDs             : PCIROOT(0)#PCI(1400)#USBROOT(0)#USB(6), ACPI(_SB_)#ACPI(PCI0)#ACPI(XHC_)#ACPI(RHUB)#ACPI(HS06)
Container ID             : {acb9ebb8-b976-57c5-b90d-5ecc5e96e487}
Manufacturer Info        : (Standard USB Host Controller)
Capabilities             : 0x94 (Removable, UniqueID, SurpriseRemovalOK)
Address                  : 6
Problem Code             : 0
Power State              : D0 (supported: D0, D3, wake from D0)
 Child Device 1          : USB Input Device
  Device ID              : USBVID_2AE2&PID_1388&MI_036&12E75DA&0&0003
  Class                  : HIDClass
   Child Device 1        : HID-compliant consumer control device
    Device ID            : HIDVID_2AE2&PID_1388&MI_037&178A021A&0&0000
    Class                : HIDClass
 Child Device 2          : USB Audio Device
  Device ID              : USBVID_2AE2&PID_1388&MI_006&12E75DA&0&0000
  Class                  : MEDIA
   Child Device 1        : Audio Endpoint
    Device ID            : SWDMMDEVAPI{0.0.1.00000000}.{0B0B6598-290C-495B-A4E1-D6A633F61574}
    Class                : AudioEndpoint
   Child Device 2        : Audio Endpoint
    Device ID            : SWDMMDEVAPI{0.0.0.00000000}.{E3ADC851-586E-4FF8-BBF3-0EBF7E72FBDA}
    Class                : AudioEndpoint
        ------------------ Device Descriptor ------------------
bLength                  : 0x12 (18 bytes)
bDescriptorType          : 0x01 (Device Descriptor)
bcdUSB                   : 0x200 (USB Version 2.00)
bDeviceClass             : 0x00 (defined by the interface descriptors)
bDeviceSubClass          : 0x00
bDeviceProtocol          : 0x00
bMaxPacketSize0          : 0x40 (64 bytes)
idVendor                 : 0x2AE2
idProduct                : 0x1388
bcdDevice                : 0x1393
iManufacturer            : 0x00 (No String Descriptor)
iProduct                 : 0x02 (String Descriptor 2)
 Language 0x0409         : "My Headset"
iSerialNumber            : 0x03 (String Descriptor 3)
 Language 0x0409         : "ABCDEF0123456789"
bNumConfigurations       : 0x01

目前,我使用此代码示例来获取产品字符串,我打开集线器并使用IOCTL_USB_get_DESCRIPTOR_FROM_NODE_CONNECTION调用DeviceIoControl来获取连接到此集线器的设备的产品字符串,但此代码不时起作用,因为有时集线器被其他人打开,CreateFile(hubPath..)失败:

// Open Hub
IntPtr handle = CreateFile(hubPath, FileAccess.ReadWrite, FileShare.ReadWrite,
    IntPtr.Zero, FileMode.Open, FileAttributes.Normal, IntPtr.Zero);
if (handle.ToInt32() != INVALID_HANDLE_VALUE)
{
    // 1. Load connection properties to get Device descriptor indexes
    LogWriter.Debug("checking device, load hub connection properties...");
    USB_NODE_CONNECTION_INFORMATION_EX connectionInfo = new USB_NODE_CONNECTION_INFORMATION_EX();
    connectionInfo.ConnectionIndex = port;
    // memset
    string NullString = new string((char)0, nBytes / Marshal.SystemDefaultCharSize);
    IntPtr connectionInfoBuffer = Marshal.StringToHGlobalAuto(NullString);
    Marshal.StructureToPtr(connectionInfo, connectionInfoBuffer, true);
    int iProductIndex = -1;
    int ioBytes = Marshal.SizeOf(connectionInfo);
    int nBytesReturned = 0;
    if (DeviceIoControl(handle,
        IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX,
        connectionInfoBuffer,
        ioBytes,
        connectionInfoBuffer,
        ioBytes,
        out nBytesReturned,
        IntPtr.Zero) != 0)
    {
        LogWriter.Debug("checking device, hub connection properties loaded");
        USB_NODE_CONNECTION_INFORMATION_EX nodeConnection = (USB_NODE_CONNECTION_INFORMATION_EX)Marshal.PtrToStructure(connectionInfoBuffer, typeof(USB_NODE_CONNECTION_INFORMATION_EX));
        if (nodeConnection.DeviceIsHub == 0)
        {
            iProductIndex = nodeConnection.DeviceDescriptor.iProduct;
            LogWriter.Debug(String.Format("GetDeviceProperties() Checking device, iProductIndex = {0}", iProductIndex));
        }
    }
    else
    {
        CheckError("DeviceIoControl");
    }
    // 2. Load iProduct descriptor
    USB_DESCRIPTOR_REQUEST stringDescReq = new USB_DESCRIPTOR_REQUEST();
    int bufSize = Marshal.SizeOf(stringDescReq) + MAXIMUM_USB_STRING_LENGTH;
    stringDescReq.ConnectionIndex = port;
    stringDescReq.SetupPacket.wValue = (short)((USB_STRING_DESCRIPTOR_TYPE << 8) | iProductIndex);
    stringDescReq.SetupPacket.wIndex = 1033; // Language code
    stringDescReq.SetupPacket.wLength = (short)(bufSize - Marshal.SizeOf(stringDescReq));
    // типа memset
    IntPtr ptrRequest = Marshal.StringToHGlobalAuto(NullString);
    Marshal.StructureToPtr(stringDescReq, ptrRequest, true);
    int nBytesRet = 0;
    LogWriter.Debug(String.Format("checking device, load USB descriptor({0}, {1}, {2})",
        stringDescReq.SetupPacket.wValue,
        stringDescReq.SetupPacket.wIndex,
        stringDescReq.SetupPacket.wLength));
    if (DeviceIoControl(handle,
        IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION,
        ptrRequest,
        bufSize,
        ptrRequest,
        bufSize,
        out nBytesRet,
        IntPtr.Zero) != 0)
    {
        int ptrSize = ptrRequest.ToInt32();
        LogWriter.Debug(String.Format("checking device, USB descriptor loaded({0}, {1})",
            ptrSize,
            Marshal.SizeOf(stringDescReq)));
        IntPtr ptrStringDesc = new IntPtr(ptrSize + Marshal.SizeOf(stringDescReq));
        USB_STRING_DESCRIPTOR StringDesc = (USB_STRING_DESCRIPTOR)Marshal.PtrToStructure(ptrStringDesc, typeof(USB_STRING_DESCRIPTOR));
        prop.ProductName = StringDesc.bString;
        if (prop.ProductName != null)
        {
            LogWriter.Debug("ProductName = " + prop.ProductName);
        }
    }
    else
    {
        LogWriter.Warn("DeviceIoControl failed");
        CheckError("DeviceIoControl");
    }
    CloseHandle(handle);
}

所以我需要另一种方法来获得稳定工作的产品字符串。

注意:当前设备是HID,因此允许使用HID的功能,但我也有非HID USB设备,如果解决方案可以同时使用HID和非HID,那就太好了。一年前,我尝试了HidD_GetProductString例程,但我记得它返回了空缓冲区(问题可能是设备路径不正确,因为HID有子设备,在这种情况下,问题是如何获得正确的设备路径)。

HidD_GetProductString是HID设备的最佳选择。您以前可能每隔一个字节就遇到。如果你使用的是HidLibrary,并且有一个HidDevice _device,你可以得到这样的产品字符串(制造商的工作方式相同):

byte[] bs;
_device.ReadProduct(out bs);
string ps = "";
foreach (byte b in bs) {
    if (b > 0)
        ps += ((char)b).ToString();
}