如何无需遍历IORegistry创建IOUSBDeviceInterface及精准定位USB设备？

在涉及自定义协议USB设备的JNI项目中，已实现枚举并操作目标USB设备，但出于JVM垃圾回收的不确定性，不希望长期持有IOUSBDeviceInterface引用。多数场景仅需获取设备元数据（PID、VID、序列号等），无需持续打开通信，希望能按需直接创建目标设备的IOUSBDeviceInterface，或缩小迭代器的扫描范围。现有枚举代码如下：

io_iterator_t iter = 0;

// 获取包含硬件信息的IO注册表根条目
io_registry_entry_t entry = IORegistryGetRootEntry(kIOMasterPortDefault);
if (entry == 0)
    throw usb_error("internal error (failed to get IO registry root entry)", 0);

// 创建USB平面的迭代器
kern_return_t kret = IORegistryEntryCreateIterator(entry, kIOUSBPlane, kIORegistryIterateRecursively, &iter);
if (kret != KERN_SUCCESS || iter == 0)
    throw usb_error("internal error (failed to create device iterator)", 0);

// 遍历迭代器
io_service_t service = 0;
while ((service = IOIteratorNext(iter)) != 0) {

    IOUSBDeviceInterface** dev = iokit_helper::get_interface<IOUSBDeviceInterface>(service, kIOUSBDeviceUserClientTypeID, kIOUSBDeviceInterfaceID);

    IOObjectRelease(service);
    if (dev == nullptr)
        continue;
    
    ... do something with dev ...
    
    (*dev)->Release(dev);
}

IOObjectRelease(iter);

一、直接通过标识符创建IOUSBDeviceInterface #

完全可以跳过遍历，通过设备的唯一标识符直接获取对应的io_service_t，再创建IOUSBDeviceInterface，推荐两种方式：

1. 保存并复用IO注册表路径 #

第一次枚举设备时，获取设备的IO注册表路径（通过IORegistryEntryCreateCFProperty读取kIORegistryPathKey）并持久化，后续直接用该路径定位设备：

// 假设已保存目标设备的注册表路径为devicePath（CFStringRef类型）
io_registry_entry_t entry = IORegistryEntryFromPath(kIOMasterPortDefault, CFStringGetCStringPtr(devicePath, kCFStringEncodingUTF8));
if (entry != 0) {
    IOUSBDeviceInterface** dev = iokit_helper::get_interface<IOUSBDeviceInterface>(entry, kIOUSBDeviceUserClientTypeID, kIOUSBDeviceInterfaceID);
    if (dev != nullptr) {
        // 按需操作设备
        (*dev)->Release(dev);
    }
    IOObjectRelease(entry);
}

2. 通过匹配字典定位唯一设备 #

利用设备的VID、PID和序列号（若支持）构建匹配字典，直接获取目标设备的io_service_t：

// 定义目标设备的标识信息
SInt16 targetVID = 0x1234;
SInt16 targetPID = 0x5678;
const char* targetSerial = "目标设备唯一序列号";

// 创建匹配字典
CFMutableDictionaryRef matchingDict = IOServiceMatching(kIOUSBDeviceClassName);
if (matchingDict) {
    CFNumberRef vid = CFNumberCreate(kCFAllocatorDefault, kCFNumberSInt16Type, &targetVID);
    CFNumberRef pid = CFNumberCreate(kCFAllocatorDefault, kCFNumberSInt16Type, &targetPID);
    CFStringRef serialNumber = CFStringCreateWithCString(kCFAllocatorDefault, targetSerial, kCFStringEncodingUTF8);
    
    // 设置过滤条件
    CFDictionarySetValue(matchingDict, CFSTR(kIOUSBVendorIDKey), vid);
    CFDictionarySetValue(matchingDict, CFSTR(kIOUSBProductIDKey), pid);
    CFDictionarySetValue(matchingDict, CFSTR(kIOUSBSerialNumberKey), serialNumber);
    
    // 获取匹配的设备服务
    io_service_t service = IOServiceGetMatchingService(kIOMasterPortDefault, matchingDict);
    if (service != 0) {
        IOUSBDeviceInterface** dev = iokit_helper::get_interface<IOUSBDeviceInterface>(service, kIOUSBDeviceUserClientTypeID, kIOUSBDeviceInterfaceID);
        if (dev != nullptr) {
            // 按需操作设备
            (*dev)->Release(dev);
        }
        IOObjectRelease(service);
    }
    
    // 释放CF资源
    CFRelease(vid);
    CFRelease(pid);
    CFRelease(serialNumber);
    CFRelease(matchingDict);
}

二、使用迭代器过滤单个设备 #

若必须保留迭代器方式，最可靠的过滤条件是VID+PID+序列号的组合（相同VID/PID的设备可能多台，但序列号唯一，前提是设备支持）。修改遍历逻辑如下：

// 定义目标设备的标识
SInt16 targetVID = 0x1234;
SInt16 targetPID = 0x5678;
const char* targetSerial = "目标设备唯一序列号";

while ((service = IOIteratorNext(iter)) != 0) {
    // 先获取设备元数据，无需创建IOUSBDeviceInterface
    CFNumberRef vidRef = (CFNumberRef)IORegistryEntryCreateCFProperty(service, CFSTR(kIOUSBVendorIDKey), kCFAllocatorDefault, 0);
    CFNumberRef pidRef = (CFNumberRef)IORegistryEntryCreateCFProperty(service, CFSTR(kIOUSBProductIDKey), kCFAllocatorDefault, 0);
    CFStringRef serialRef = (CFStringRef)IORegistryEntryCreateCFProperty(service, CFSTR(kIOUSBSerialNumberKey), kCFAllocatorDefault, 0);
    
    SInt16 vid = 0, pid = 0;
    bool isTargetDevice = false;
    
    if (vidRef && pidRef && serialRef) {
        CFNumberGetValue(vidRef, kCFNumberSInt16Type, &vid);
        CFNumberGetValue(pidRef, kCFNumberSInt16Type, &pid);
        CFStringRef targetSerialRef = CFStringCreateWithCString(kCFAllocatorDefault, targetSerial, kCFStringEncodingUTF8);
        isTargetDevice = (vid == targetVID && pid == targetPID && CFStringCompare(serialRef, targetSerialRef, 0) == kCFCompareEqualTo);
        CFRelease(targetSerialRef);
    }
    
    // 仅处理目标设备
    if (isTargetDevice) {
        IOUSBDeviceInterface** dev = iokit_helper::get_interface<IOUSBDeviceInterface>(service, kIOUSBDeviceUserClientTypeID, kIOUSBDeviceInterfaceID);
        if (dev != nullptr) {
            ... do something with dev ...
            (*dev)->Release(dev);
        }
    }
    
    // 释放资源
    if (vidRef) CFRelease(vidRef);
    if (pidRef) CFRelease(pidRef);
    if (serialRef) CFRelease(serialRef);
    IOObjectRelease(service);
}

补充说明 #

• 若设备无序列号，可使用kIORegistryEntryIDKey（系统分配的唯一整数ID）作为标识，但设备断开重连后该ID会变化。
• JNI环境中需手动释放所有Core Foundation对象，避免内存泄漏，JVM无法自动管理这类资源。

内容的提问来源于stack exchange，提问作者Codo