readfile异步调用必须配合有效overlapped结构体，且文件句柄需以file_flag_overlapped创建；返回false且getlasterror为error_io_pending才表示异步启动成功；overlapped须独立、生命周期覆盖整个io过程；完成通知应根据场景选用事件、iocp或轮询。
ReadFile异步调用必须配OVERLAPPED结构体
不传OVERLAPPED*或传nullptr，ReadFile就走同步路径，哪怕你开了FILE_FLAG_OVERLAPPED。Windows 会直接忽略异步标志——这是最常踩的坑。
必须提前分配好OVERLAPPED实例（不能栈上临时构造后传地址，因为IO可能在函数返回后才完成），并初始化hEvent字段（可设为NULL，但此时必须用GetOverlappedResult轮询或WaitForSingleObject等待）。
-
OVERLAPPED内存生命周期必须覆盖整个IO周期，建议堆分配或静态/成员变量 - 若用事件通知，记得调用
CreateEvent创建手动重置事件，并在ReadFile前赋给OVERLAPPED.hEvent - 不要重复复用同一个
OVERLAPPED结构体发起多个并发读——每个IO操作需独立OVERLAPPED
调用ReadFile返回FALSE不等于失败
异步模式下，ReadFile返回FALSE且GetLastError()返回ERROR_IO_PENDING，才是正常异步启动成功的信号。如果返回TRUE，说明数据已立即就绪（比如文件缓存命中），实际已完成读取——这反而容易被误判为“没走异步”。
- 必须检查
GetLastError()，仅靠返回值无法区分同步完成 vs 异步排队 -
ERROR_IO_PENDING是唯一表示“已提交、正在后台执行”的错误码 - 其他错误码（如
ERROR_HANDLE_EOF、ERROR_ACCESS_DENIED）才是真失败，需立刻处理
完成通知有三种方式，选错会导致线程阻塞或资源泄漏
WinAPI 提供事件、I/O完成端口（IOCP）、GetOverlappedResult轮询三种方式。普通应用别默认选事件——它要求每IO一个事件对象，开销大且易漏CloseHandle；IOCP适合高并发，但需要额外线程池管理；轮询最简单，但bWait=FALSE时GetOverlappedResult会立即返回FALSE，需配合WaitForSingleObject或MsgWaitForMultipleObjects。
- 用事件方式：调用
WaitForSingleObject(overlapped.hEvent, INFINITE)后，必须调用GetOverlappedResult获取实际字节数和错误状态 - 用IOCP：手动生成
hCompletionPort，绑定句柄，投递PostQueuedCompletionStatus，再用GetQueuedCompletionStatus收包——ReadFile本身不触发回调 - 轮询方式：
GetOverlappedResult(hFile, &ol, &bytes, FALSE)返回FALSE且GetLastError()==ERROR_IO_INCOMPLETE，说明还没完，需稍后重试
文件句柄必须用FILE_FLAG_OVERLAPPED创建
用CreateFile打开文件时，dwFlagsAndAttributes参数漏掉FILE_FLAG_OVERLAPPED，后续所有ReadFile异步调用都会退化成同步，且不报错、不警告——行为静默失效。
- 即使设备驱动支持异步，用户模式句柄也必须显式声明
FILE_FLAG_OVERLAPPED - 管道、串口等设备句柄同理，缺这个flag就只能同步
-
FILE_ATTRIBUTE_NORMAL和FILE_FLAG_OVERLAPPED可以共存，别误以为二者互斥
异步读的核心约束其实就四条：句柄带flag、OVERLAPPED独立且存活、返回ERROR_IO_PENDING才算启动成功、完成通知方式要匹配资源模型。漏掉任意一条，表面代码能跑，实际全是同步阻塞。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
