Windows下串口写入完成等待实现失败，求技术解决方案

问题根源 #

1. 重叠IO下WriteFile直接返回TRUE的原因
   当你用重叠IO调用WriteFile时，如果串口驱动的发送缓冲区有足够空间容纳待写入的所有字节，WriteFile会直接把数据拷贝到驱动缓冲区，随即返回TRUE，不会触发重叠结构的事件对象。此时数据只是进入了驱动缓冲区，并未真正发送到硬件——这就是你没进入等待逻辑的核心原因。

2. WaitCommEvent无效的原因
   默认情况下WaitCommEvent只监听接收类事件（比如EV_RXCHAR），如果没通过SetCommMask明确设置监听EV_TXEMPTY事件，它根本不会关注发送完成状态。就算设置了掩码，也得确保在调用WaitCommEvent前完成正确配置。

解决方法 #

方法一：正确用重叠IO等待硬件发送完成 #

需要分两步：先把数据写入驱动缓冲区，再等待串口硬件将所有数据发送完毕（即发送缓冲区为空）。示例代码逻辑如下：

BOOL WriteAndWaitForCompletion(HANDLE hSerial, const char* buffer, DWORD bufferSize) {
    OVERLAPPED ovWrite = {0};
    ovWrite.hEvent = CreateEvent(NULL, TRUE, FALSE, NULL);
    if (ovWrite.hEvent == NULL) return FALSE;

    DWORD bytesWritten;
    BOOL writeResult = WriteFile(hSerial, buffer, bufferSize, &bytesWritten, &ovWrite);

    // 若WriteFile返回FALSE且错误为ERROR_IO_PENDING，说明操作在后台执行
    if (!writeResult && GetLastError() == ERROR_IO_PENDING) {
        // 等待数据写入驱动缓冲区完成
        if (!GetOverlappedResult(hSerial, &ovWrite, &bytesWritten, TRUE)) {
            CloseHandle(ovWrite.hEvent);
            return FALSE;
        }
    }

    // 等待硬件发送完成（发送缓冲区为空）
    OVERLAPPED ovWait = {0};
    ovWait.hEvent = CreateEvent(NULL, TRUE, FALSE, NULL);
    if (ovWait.hEvent == NULL) {
        CloseHandle(ovWrite.hEvent);
        return FALSE;
    }

    // 设置监听发送缓冲区为空的事件掩码
    if (!SetCommMask(hSerial, EV_TXEMPTY)) {
        CloseHandle(ovWrite.hEvent);
        CloseHandle(ovWait.hEvent);
        return FALSE;
    }

    DWORD evtMask;
    BOOL waitResult = WaitCommEvent(hSerial, &evtMask, &ovWait);
    if (!waitResult && GetLastError() == ERROR_IO_PENDING) {
        GetOverlappedResult(hSerial, &ovWait, &bytesWritten, TRUE);
    }

    CloseHandle(ovWrite.hEvent);
    CloseHandle(ovWait.hEvent);
    return TRUE;
}

方法二：轮询发送缓冲区状态（简单但不推荐） #

如果不想用事件等待，可通过轮询检查发送缓冲区剩余字节数：

void WaitForTxEmpty(HANDLE hSerial) {
    COMSTAT stat;
    DWORD errors;
    do {
        ClearCommError(hSerial, &errors, &stat);
        // stat.cbOutQue为发送缓冲区剩余字节数
    } while (stat.cbOutQue > 0);
}

这种方法实现简单，但会持续占用CPU，仅适合小数据量或对性能要求不高的场景。

关键注意事项 #

• 打开串口时必须指定FILE_FLAG_OVERLAPPED标志，否则重叠IO功能无效。
• 每次使用重叠结构的事件对象后要及时关闭，避免系统资源泄漏。
• EV_TXEMPTY事件是当发送缓冲区最后一个字节被硬件发送时触发，这才是你需要等待的真正完成状态。

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