hosteons中文网

函数 ReadFile 从输入文件中读取文本。其原型如下：

ReadFile PROTO,
    hFile:HANDLE,                                            ;输入句柄
    lpBuffer:PTR BYTE,                                     ;缓冲区指针
    nNumberOfBytesToRead:DWORD,           ;读取的字节数
    lpNumberOfBytesRead:PTR DWORD,       ;实际读出的 字节数
    lpOverlapped:PTR DWORD                       ;异步信息指针

其中：

• hFile 是由 CreateFile 返回的打开文件的句柄；
• lpBuffer 指向的缓冲区接收从该文件读取的数据；
• nNumberOfBytesToRead 定义从该文件读取的最大字节数；
• lpNumberOfBytesRead 指向的整数为函数返回时实际读取的字节数；
• lpOverlapped 应被设置为 NULL(0)。若函数调用失败，则返回值为零。

如果对同一个打开文件的句柄进行多次调用，那么 ReadFile 就会记住最后一次读取的位置，并从这个位置开始读。换句话说，函数有一个内部指针指向文件内的当前位置。

ReadFile 还可以运行在异步模式下，这意味着调用程序不用等到读操作完成。