win32 CreateFile

CreateFile函数详解

最新推荐文章于 2025-10-21 09:20:07 发布

原创最新推荐文章于 2025-10-21 09:20:07 发布 · 3.1k 阅读

2 ·

CC 4.0 BY-SA版权

win32-api 专栏收录该内容

85 篇文章

订阅专栏

本文详细介绍了Windows API中的CreateFile函数，该函数用于创建或打开文件及I/O设备。文章解释了函数的各个参数，包括文件名、访问模式、共享模式等，并提供了不同应用场景的例子。

1 参考资料：

msdn：

函数定义
https://msdn.microsoft.com/en-us/library/windows/desktop/aa363858(v=vs.85).aspx

例子：Opening a File for Reading or Writing
https://msdn.microsoft.com/en-us/library/windows/desktop/bb540534(v=vs.85).aspx
例子:串口 Configuring a Communications Resource
https://msdn.microsoft.com/en-us/library/windows/desktop/aa363201(v=vs.85).aspx
例子: 监控串口事件 Monitoring Communications Events
https://msdn.microsoft.com/en-us/library/windows/desktop/aa363424(v=vs.85).aspx

《windows高级编程指南》第15章设备I/O 重点

2 函数介绍

创建或者打开一个文件或者I/O设备.
通用的I/O设备，包括下面这些：
文件
文件流
目录
物理盘
volume 磁盘卷逻辑盘
控制台缓冲区
磁带驱动器，
通信资源串行口和并行口应该包括USB 口吧
邮槽和管道

根据所访问对象以及所指定访问特性标识的不同，该函数会返回一个用于访问所指定对象的句柄

3 函数原型

HANDLE WINAPI CreateFile(
  _In_     LPCTSTR               lpFileName,    // 设备名称
  _In_     DWORD                 dwDesiredAccess, // 读还是写
  _In_     DWORD                 dwShareMode,     // 对文件的访问独占
  _In_opt_ LPSECURITY_ATTRIBUTES lpSecurityAttributes, //可以传NULL
  _In_     DWORD                 dwCreationDisposition, //创建或者打开文件的方式
  _In_     DWORD                 dwFlagsAndAttributes,  //
  _In_opt_ HANDLE                hTemplateFile          // 可以为NULL
);

4 参数解析

lpFileName

设备名称指向文件名的指针

dwDesiredAccess

0 不想读写设备数据，只想改变设备的配置—-如文件的时间戳—-应传递0
GENERIC_READ 只读访问
GENERIC_WRITE 只写访问用于向打印机传递数据或者备份软件
GENERIC_READ | GENERIC_WRITE 允许对设备的读写

dwShareMode

0 阻止其他进程打开文件，当该进程想要删除，读或者写访问该文件
FILE_SHARE_DELETE
FILE_SHARE_READ
FILE_SHARE_WRITE

lpSecurityAttributes 指向安全属性的指针

可以为NULL

dwCreationDisposition

当文件存在或不存在，该函数的默认行为

CREATE_ALWAYS
如果指定的文件存在并且是可写的，函数会覆盖该文件，
函数成功返回，最后的last-error code 设置为ERROR_ALREADY_EXISTS(183)
如果指定的文件不存在，但是是一个有效的路径，会创建新的文件，
函数成功返回，last-error code为 0
CREATE_NEW
创建一个新的文件，需要这个文件不存在
如果文件存在，函数失败，返回 ERROR_FILE_EXISTS (80).
如果文件不存在，但是是一个有效的可写的路径位置，会创建一个新的文件
OPEN_ALWAYS
打开一个文件，
如果文件存在，函数正确返回，ERROR_ALREADY_EXISTS (183).
如果不存在，创建一个文件，并且返回0
OPEN_EXISTING
如果文件存在就打开
如果文件不存在，函数失败，返回ERROR_FILE_NOT_FOUND（2）
TRUNCATE_EXISTING
打开一个已经存在的文件，并将其大小设置为0
如果文件不存在，则失败，GENERIC_WRITE标志必须同该标志一起使用。

dwFlagsAndAttributes 文件属性和标志

可以为0，一般的普遍的默认值是FILE_ATTRIBUTE_NORMAL ，这个一般是单独使用
有两个作用：它允许微调同设备的通信，如果设备是文件，还能设置文件的属性。
大多数的标志告诉系统你打算如何访问设备。系统可以优化它的缓冲算法来帮助程序工作得更有效

其中的一个标志是 FILE_FLAG_OVERLAPPED ,告诉系统，你想要异步的访问一个设备。
打开设备的缺省方式是同步I/O（不指定FILE_FLAG_OVERLAPPED）。阻塞的写和读。
因为设备I/O同大多数其他操作相比较缓慢，你可能会想要异步通信某些设备。
简单的说是，你调用一个函数告诉操作系统去读写数据，但是不必要等到I/O结束。
你的调用立即返回。操作系统使用它的线程，为你完成I/O。
当操作系统完成了你请求的I/O的时候，你会得到通知。
异步I/O是设计应该用程序时，一种很方便的方法。

hTemplateFile

标识一个打开的句柄或者为NULL