ReadFileEx

ReadFileEx是一個Windows API函數。與ReadFile相似，只是它只能用於異步讀取文件操作，異步操作完成後會調用指定的回調函數。

BOOL ReadFileEx(
HANDLE                             hFile,                   //文件的句柄
LPVOID                             lpBuffer,                //用於接收數據的緩衝區
DWORD                              nNumberOfByteToRead,     //允許接收的最大字節數
LPOVERLAPPED                       lpOverlapped,            //一個OVERLAPPED結構的指針
LPOVERLAPPED_COMPLETION_ROUTINE    lpCompletionRoutine      //異步讀取完成後調用的回調函數
);

參數

1、hFile

文件的句柄。這個參數可以是任何一個由帶有FILE_FLAG_OVERLAPPED參數的CreateFile函數打開的句柄。這個句柄同時也需要有GENERIC_WRITE訪問權限。

2、lpBuffer

指定容納讀入數據的一個緩衝區。除非讀操作執行完畢，否則不要訪問這個緩衝區。

3、nNumberOfBytesToRead

要讀入的字節數。

4、lpOverlapped

一個指向OVERLAPPED類型的結構體指針，定義了一個異步操作的結構。使用這個函數時，結構中的hEvent字段會被忽略

5、lpCompletionRoutine

回調函數的返回值。 [1] 

返回值

返回TRUE表示成功；

返回FALSE表示失敗，並可用GetLastError得到錯誤代碼。