如何实现USB HID设备的非阻塞写入并设置超时？

你的核心问题出在没有启用真正的重叠IO，且轮询等待的方式既低效又无法可靠终止阻塞的IO操作。以下是兼容Windows XP及以上版本的解决方案：

关键修正点 #

• 创建文件时必须指定FILE_FLAG_OVERLAPPED：这是启用重叠IO的必要条件，否则WriteFileEx会退化为同步调用，自然会阻塞。
• 用等待函数替代轮询sleep：利用WaitForSingleObject等待重叠IO的事件对象，同时直接设置超时时间，避免无效轮询。
• 超时后主动取消IO操作：一旦超时，调用CancelIo终止未完成的IO，确保资源正确释放。

修正后的代码示例 #

#include <windows.h>
#include <thread>

#define WRITE_TIMEOUT_MS 5000 // 自定义超时时间

BOOL WriteHidDeviceWithTimeout(HANDLE hFile, const BYTE* buffer, DWORD length)
{
    if (hFile == INVALID_HANDLE_VALUE)
        return FALSE;

    OVERLAPPED overlapped = {0};
    // 创建手动重置的事件，初始为无信号状态
    overlapped.hEvent = CreateEvent(NULL, TRUE, FALSE, NULL);
    if (overlapped.hEvent == NULL)
        return FALSE;

    // 启动异步写操作
    BOOL result = WriteFileEx(hFile, (LPVOID)buffer, length, &overlapped, NULL);
    if (!result)
    {
        // 若调用失败，直接清理事件
        CloseHandle(overlapped.hEvent);
        return FALSE;
    }

    // 等待IO完成或超时
    DWORD waitResult = WaitForSingleObject(overlapped.hEvent, WRITE_TIMEOUT_MS);
    switch (waitResult)
    {
        case WAIT_OBJECT_0:
            // IO完成，检查实际写入字节数
            DWORD bytesWritten;
            GetOverlappedResult(hFile, &overlapped, &bytesWritten, FALSE);
            CloseHandle(overlapped.hEvent);
            return (bytesWritten == length);

        case WAIT_TIMEOUT:
            // 超时，取消IO操作
            CancelIo(hFile);
            // 等待取消完成（避免资源泄漏）
            WaitForSingleObject(overlapped.hEvent, INFINITE);
            CloseHandle(overlapped.hEvent);
            return FALSE;

        default:
            // 等待出错，清理资源
            CloseHandle(overlapped.hEvent);
            return FALSE;
    }
}

// 调用示例
int main()
{
    HANDLE hFile = CreateFileW(L"\\\\?\\HID#VID_XXXX&PID_XXXX#...", 
                               GENERIC_WRITE, 
                               FILE_SHARE_READ | FILE_SHARE_WRITE, 
                               NULL, 
                               OPEN_EXISTING, 
                               FILE_FLAG_OVERLAPPED, // 必须指定此标志
                               NULL);

    if (hFile != INVALID_HANDLE_VALUE)
    {
        BYTE buffer[64] = {0};
        BOOL writeSuccess = WriteHidDeviceWithTimeout(hFile, buffer, sizeof(buffer));
        CloseHandle(hFile);
    }
    return 0;
}

额外说明 #

• CancelIo在Windows XP及以上均支持，能终止指定句柄上所有未完成的重叠IO操作。
• 必须调用GetOverlappedResult获取实际写入字节数，即使IO成功完成也需要确认写入长度是否符合预期。
• 事件句柄必须手动关闭，避免资源泄漏。

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