Windows ＡＰＩ之WriteFile函数详细解答

WriteFile
WriteFile函数将数据写到一个文件中，它是为同步和异步操作而设计的。函数在文件指针指示的位置开始向文件写入数据。写操作完成后，文件指针将根据实际写入的字节数进行调整，除非文件是用FILE_FLAG_OVERLAPPED打开的。如果文件句柄是为重叠的输入和输出(I/O)创建的，则应用程序必须在写操作完成后调整文件指针的位置。

BOOL WriteFile (
handle hFile， //处理要写入的文件
LPCVOID lpBuffer， //指向要写入文件的数据的指针
DWORD nNumberOfBytesToWrite， //要写入的字节数
LPDWORD lpNumberOfBytesWritten， //指针写入的字节数
指向重叠I/O结构的指针
);

参数
hFile
要写入的文件的句柄。文件句柄必须是使用对文件的GENERIC_WRITE访问权限创建的。
Windows NT:
对于异步写操作，hFile可以是CreateFile函数用FILE_FLAG_OVERLAPPED标记打开的任何句柄，也可以是thesocket或accept函数返回的套接字句柄。
Windows 95:
对于异步写操作，hFile可以是通信资源、邮件槽或命名管道句柄，由CreateFile使用FILE_FLAG_OVERLAPPED标记打开，也可以是套接字或accept函数返回的套接字句柄。Windows 95不支持对磁盘文件进行异步写操作。
lpBuffer
指向包含要写入文件的数据的缓冲区的指针。
nNumberOfBytesToWrite
要写入文件的字节数。
0的值指定一个空写操作。空写操作不写入任何字节，但会导致时间戳更改。

跨网络的命名管道写操作限制为65,535字节。

lpNumberOfBytesWritten
指向此函数调用写入的字节数的指针。WriteFile在执行任何工作或错误检查之前将此值设置为0。
如果llapped是NULL, lpNumberOfBytesWritten不能为空。

windowsnt:如果llapping不为空，lpNumberOfBytesWritten可以为空。如果这是一个重叠的写操作，那么可以通过调用GetOverlappedResult来获得写的字节数。如果hFile与I/O完成端口相关联，则可以通过调用GetQueuedCompletionStatus获得写入的字节数。

Windows 95和Windows 98:该参数不能为空。

lpOverlapped
指向重叠结构的指针。如果用FILE_FLAG_OVERLAPPED打开hFile，则需要这个结构。
如果用FILE_FLAG_OVERLAPPED打开hFile，则llapped参数不能为空。它必须指向有效的重叠结构。如果用FILE_FLAG_OVERLAPPED打开hFile，并且llapped为NULL，则该函数可能会错误地报告写操作已经完成。

如果用FILE_FLAG_OVERLAPPED打开hFile，并且llapped不为空，则写操作从重叠结构中指定的偏移量开始，写文件可能在写操作完成之前返回。在本例中，WriteFile返回FALSE, GetLastError函数返回ERROR_IO_PENDING。这允许调用进程在写操作完成时继续处理。在重叠结构中指定的事件在写操作完成时被设置为有信号状态。

如果没有使用FILE_FLAG_OVERLAPPED打开hFile，并且llapped为NULL，则写操作从当前文件位置开始，直到操作完成后才返回WriteFile。

如果未使用FILE_FLAG_OVERLAPPED打开hFile，并且llapped不为空，则从重叠结构中指定的偏移量处开始写操作，直到写操作完成后，WriteFile才返回。

返回值
如果函数成功，则返回值为非零。

如果函数失败，则返回值为零。要获取扩展的错误信息，请调用GetLastError。

讲话
当使用FILE_FLAG_NO_BUFFERING打开文件时，应用程序必须满足某些要求:

文件访问必须从卷扇区大小的整数倍的文件中的字节偏移量开始。要确定卷的扇区大小，请调用GetDiskFreeSpace函数。
文件访问必须是卷扇区大小的整数倍的字节数。例如，如果扇区大小是512字节，则应用程序可以请求读写512、1024或2048字节，但不能请求读写335、981或7171字节。
用于读写操作的缓冲区地址必须按扇区对齐(按内存中卷扇区大小的整数倍进行对齐)。扇区对齐缓冲区的一种方法是使用VirtualAlloc函数来分配缓冲区。此函数分配按地址对齐的内存