获取USB设备的产品字符串(C#/C++)
Get product string of USB device (C#/C++)
如何从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设备的最佳选择。您以前可能每隔一个字节就遇到