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函数来分配缓冲区。此函数分配按地址对齐的内存

Windows ＡＰＩ之WriteFile函数详细解答相关推荐

使用Signature Tool自动生成P/Invoke调用Windows API的C#函数声明
使用Signature Tool自动生成P/Invoke调用Windows API的C#函数声明分类: 小技巧 Win32编程 C++ 解决难题 .NET2009-02-05 20:53 5186人 ...
GetOverlappedResult函数详细解答
GetOverlappedResult GetOverlappedResult函数返回指定文件.指定管道或通信设备上重叠操作的结果. Windows95:此功能只适用于通讯设备或使用DeviceIoC ...
Windows API CreateFile WriteFile 操作文件追加写入解决中文乱码
编译环境 WIn10 21H1 VS2017 字符集随意切换解决乱码问题! 切换字符集后必需删除之前的文本文件! // CreateFile.cpp : 此文件包含 "main" ...
纯C语言用Windows api写画函数图像
!!!如有转载请注明出处!!! 主要功能介绍: 1.输入函数的解析式,可以在窗口中画出解析式的函数图像. 2.解析式只能以x为自变量. 3.解析式目前只能写数字.括号.加减乘除四则运算(±*/),不 ...
torch.atan2函数详细解答
先看看arctan arctan实际上是用来计算点(x,y)组成的向量,与x轴的弧度的,是tan的反函数,推导如下,α为弧度 y=arctan(x)其图像如下 y为弧度,x为任意值,这里不是指 ...
Windows API函数速查
http://blog.csdn.net/ghevinn/article/details/8213614 Windows API函数速查 1. API之网络函数 WNetAddConnection 创 ...
标准C函数库头文件、POSIX标准库头文件和Windows API函数库头文件说明
1. 标准C函数库头文件名字源自描述 <assert.h> 包含断言宏,被用来在程序的调试版本中帮助检测逻辑错误以及其他类型的bug. <complex.h> C99 一 ...
delphi调用windows api
在Delphi中调用Windows API 函数十分方便,只需在单元的uses段加入Windows 单元名即可(对于由Delphi自动创建的单元,该项工作已经完成).单元Windows.pas 已经由 ...
C/C++中Windows API 简单的(Callback)回调机制
首先来说说什么是调用和回调当一个程序调用windows API时的过程称为Call 当windows API调用程序里面的函数时这称之为Callback 下面举一个简单的例子来说明回调的用途编写一 ...

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

Windows ＡＰＩ之WriteFile函数详细解答相关推荐

最新文章

热门文章