ReadFileEx调用驱动器句柄返回成功但未读取数据问题排查

兄弟，你这问题典型是没搞懂ReadFileEx的异步IO逻辑——它返回ERROR_SUCCESS（0）只是说异步请求提交成功了，不是数据已经读进缓冲区了！你急着看缓冲区的时候，IO操作可能还没真正完成呢，自然是空的。

我给你梳理几个必须修正的点，附完整示例代码：

1. 异步IO的核心误区：返回成功≠操作完成 #

ReadFileEx是异步重叠IO接口，调用成功只代表系统接受了你的读取请求，实际的磁盘读取操作是在后台进行的。你必须等待IO操作完成后，才能去访问缓冲区。

2. 必须正确初始化OVERLAPPED结构 #

异步IO依赖OVERLAPPED来跟踪操作状态，你得给它绑定一个事件，还要设置读取的偏移量（要读第一个扇区，偏移就是0）：

OVERLAPPED ov = {0};
// 创建手动重置事件，用于等待IO完成
ov.hEvent = CreateEvent(NULL, TRUE, FALSE, NULL);
if (ov.hEvent == NULL) {
    _tprintf(_T("CreateEvent failed: %lu\n"), GetLastError());
    return 1;
}
// 设置读取起始位置：驱动器第0字节（第一个扇区）
ov.Offset = 0;
ov.OffsetHigh = 0;

3. 打开驱动器时必须加FILE_FLAG_OVERLAPPED #

异步IO要求句柄是用FILE_FLAG_OVERLAPPED标志打开的，否则ReadFileEx的行为会异常：

HANDLE hDrive = CreateFileW(L"\\\\.\\PhysicalDrive0",
                            GENERIC_READ,
                            FILE_SHARE_READ | FILE_SHARE_WRITE,
                            NULL,
                            OPEN_EXISTING,
                            FILE_FLAG_OVERLAPPED, // 这个标志必须加！
                            NULL);

4. 等待IO完成后再访问缓冲区 #

有两种可靠的方式等待异步IO完成：

方式一：用WaitForSingleObject等待事件 #

BOOL result = ReadFileEx(hDrive, buffer, 512, &ov, NULL);
if (!result) {
    _tprintf(_T("ReadFileEx failed: %lu\n"), GetLastError());
    // 清理资源
    return 1;
}
// 无限等待IO完成，也可以设置超时时间
DWORD waitRes = WaitForSingleObject(ov.hEvent, INFINITE);
if (waitRes != WAIT_OBJECT_0) {
    _tprintf(_T("IO wait failed: %lu\n"), GetLastError());
    // 清理资源
    return 1;
}
// 现在缓冲区才有数据！

方式二：用GetOverlappedResult（推荐，还能获取实际读取字节数） #

DWORD bytesRead;
BOOL result = ReadFileEx(hDrive, buffer, 512, &ov, NULL);
if (!result) {
    _tprintf(_T("ReadFileEx failed: %lu\n"), GetLastError());
    // 清理资源
    return 1;
}
// 第三个参数TRUE表示等待IO完成
if (!GetOverlappedResult(hDrive, &ov, &bytesRead, TRUE)) {
    _tprintf(_T("GetOverlappedResult failed: %lu\n"), GetLastError());
    // 清理资源
    return 1;
}
// 验证读取字节数是否符合预期
if (bytesRead != 512) {
    _tprintf(_T("只读取了%lu字节，预期512字节\n"), bytesRead);
}

5. 缓冲区要避免用栈局部变量 #

如果你的缓冲区是函数内的栈变量，万一IO还没完成函数就返回了，栈会被销毁，缓冲区就失效了。建议用堆分配：

BYTE* buffer = (BYTE*)HeapAlloc(GetProcessHeap(), 0, 512);
if (buffer == NULL) {
    _tprintf(_T("内存分配失败\n"));
    return 1;
}
// 用完记得释放
HeapFree(GetProcessHeap(), 0, buffer);

完整修正后的示例代码 #

#define UNICODE
#define _UNICODE
#include <windows.h>
#include <winioctl.h>
#include <stdio.h>
#include <tchar.h>

int _tmain(int argc, TCHAR* argv[]) {
    // 注意：必须以管理员权限运行！
    HANDLE hDrive = CreateFileW(L"\\\\.\\PhysicalDrive0",
                                GENERIC_READ,
                                FILE_SHARE_READ | FILE_SHARE_WRITE,
                                NULL,
                                OPEN_EXISTING,
                                FILE_FLAG_OVERLAPPED,
                                NULL);
    if (hDrive == INVALID_HANDLE_VALUE) {
        _tprintf(_T("打开驱动器失败: %lu\n"), GetLastError());
        return 1;
    }

    // 验证驱动器几何信息（你已完成这步，保留即可）
    DISK_GEOMETRY_EX dgEx;
    DWORD bytesReturned;
    if (!DeviceIoControl(hDrive, IOCTL_DISK_GET_DRIVE_GEOMETRY_EX,
                         NULL, 0, &dgEx, sizeof(dgEx), &bytesReturned, NULL)) {
        _tprintf(_T("获取驱动器信息失败: %lu\n"), GetLastError());
        CloseHandle(hDrive);
        return 1;
    }
    _tprintf(_T("每磁道扇区数: %lu\n"), dgEx.Geometry.SectorsPerTrack);

    // 分配512字节缓冲区
    BYTE* buffer = (BYTE*)HeapAlloc(GetProcessHeap(), 0, 512);
    if (buffer == NULL) {
        _tprintf(_T("内存分配失败\n"));
        CloseHandle(hDrive);
        return 1;
    }

    // 初始化OVERLAPPED结构
    OVERLAPPED ov = {0};
    ov.hEvent = CreateEvent(NULL, TRUE, FALSE, NULL);
    if (ov.hEvent == NULL) {
        _tprintf(_T("创建事件失败: %lu\n"), GetLastError());
        HeapFree(GetProcessHeap(), 0, buffer);
        CloseHandle(hDrive);
        return 1;
    }
    ov.Offset = 0;
    ov.OffsetHigh = 0;

    // 提交异步读取请求
    BOOL readResult = ReadFileEx(hDrive, buffer, 512, &ov, NULL);
    if (!readResult) {
        _tprintf(_T("提交读取请求失败: %lu\n"), GetLastError());
        CloseHandle(ov.hEvent);
        HeapFree(GetProcessHeap(), 0, buffer);
        CloseHandle(hDrive);
        return 1;
    }

    // 等待IO完成并获取读取结果
    DWORD bytesRead;
    if (!GetOverlappedResult(hDrive, &ov, &bytesRead, TRUE)) {
        _tprintf(_T("读取操作失败: %lu\n"), GetLastError());
        CloseHandle(ov.hEvent);
        HeapFree(GetProcessHeap(), 0, buffer);
        CloseHandle(hDrive);
        return 1;
    }

    // 输出读取结果
    _tprintf(_T("成功读取%lu字节\n"), bytesRead);
    _tprintf(_T("前16字节数据: "));
    for (int i = 0; i < 16; i++) {
        _tprintf(_T("%02X "), buffer[i]);
    }
    _tprintf(_T("\n"));

    // 清理所有资源
    CloseHandle(ov.hEvent);
    HeapFree(GetProcessHeap(), 0, buffer);
    CloseHandle(hDrive);
    return 0;
}

最后几个注意事项 #

• 必须管理员权限运行：Windows对物理驱动器的访问有严格权限控制，普通用户权限打不开。
• 如果想用ReadFileEx的回调函数：需要调用SleepEx或MsgWaitForMultipleObjectsEx让线程进入可警告等待状态，否则回调不会触发（我们上面用等待事件的方式更简单直观）。
• 测试时注意驱动器编号：\\\\.\\PhysicalDrive0是第一个物理驱动器，如果你要读其他驱动器，要改成对应的编号。

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