串口之CreateFile 函数具体解释

Posted 2020-09-22 slgkaifa

HANDLE CreateFile(

LPCTSTR lpFileName, //指向文件名称的指针

DWORD dwDesiredAccess, //訪问模式（写/读）

DWORD dwShareMode, //共享模式

LPSECURITY_ATTRIBUTES lpSecurityAttributes, //指向安全属性的指针

DWORD dwCreationDisposition, //怎样创建

DWORD dwFlagsAndAttributes, //文件属性

HANDLE hTemplateFile //用于拷贝文件句柄

);

參数列表:
lpFileName

//指向一个空结尾字符串。

该參数指定了用于创建或打开句柄的对象。假设lpFileName的对 象是一个路径，则有一个最大字符数的限制。

不能超过常量(MAX_PATH).这个限制指示了CreateFile函数怎样解析路径.

dwDesiredAccess

//指定对象的訪问方式,程序能够获得读訪问权,写訪问权,读写訪问权或者是询问设备("device query") 訪问权.

这个參数能够是下列值的随意组合： 

0             //指定询问訪问权.程序能够在不直接訪问设备的情况下查询设备的属性. 

GENERIC_READ //指定读訪问权.能够从文件里读取数据,而且移动文件指针.能够和GENERIC_WRITE组合成为"读写訪问权". GENERIC_WRITE //指定写訪问权.能够从文件里写入数据,而且移动文件指针.能够和GENERIC_READ组合成为"读写訪问权".

dwShareMode
//设置位标志指明对象如休共享.假设參数是0, 对象不可以共享. 兴许的打开对象的操作将会失败,直到该对象的句柄关闭.

使用一个或多个下列值的组合来共享一个对象：

FILE_SHARE_DELETE //WINDOWS NT:兴许的只请求删除訪问权的打开操作将会成功.

FILE_SHARE_READ //兴许的只请求读訪问权的打开操作将会成功.

FILE_SHARE_WRITE //兴许的只请求写訪问权的打开操作将会成功.

lpSecurityAttributes

//指向一个 SECURITY_ATTRIBUTES 结构的指针用于确定怎样在子进程中继承这个句柄.假设这个參数是NULL,则该句柄不可继承.

dwCreationDisposition

//指定当文件存在或者不存在时怎样动作。

关于这个參数很多其它的信息。參考批注部分。这个參数必须是一个或多个下列值：

CREATE_NEW //创建一个新文件. 假设该文件已经存在函数则会失败.

CREATE_ALWAYS //创建一个新文件.假设该文件已经存在,函数将覆盖已存在的文件并清除已存在的文件属性

OPEN_EXISTING //打开一个文件,假设文件不存在函数将会失败.如查你使用CreateFile函数为设备装载控制台.请查看批注中的"为什么使用OPEN_EXISTING标志"的部分.

OPEN_ALWAYS //假设文件存在,打开文件. 假设文件不存在,而且參数中有CREATE_NEW标志,则创建文件.

TRUNCATE_EXISTING //打开一个文件,每次打开,文件将被截至0字节.调用进程必须用GENERIC_WRITE訪问模式打开文件.假设文件不存在则函数就会失败.

dwFlagsAndatributes
//为文件指定属性和标志位

该參数能够接收下列属性的随意组合.除非其他全部的文件属性忽略FILE_ATTRIBUTE_NORMAL.

FILE_ATTRIBUTE_ARCHIVE //文件将被存档,程序使用此属性来标志文件去备份或移除

FILE_ATTRIBUTE_HIDDEN //文件被隐藏,它不会在一般目录列表中被装载.

FILE_ATTRIBUTE_NORMAL //文件没有被设置不论什么属性.

FILE_ATTRIBUTE_OFFLINE //文件的数据没有被马上用到。指出正在脱机使用该文件。

FILE_ATTRIBUTE_READONLY //这个文件仅仅可读取.程序能够读文件,但不能够在上面写入内容,也不可删除.

FILE_ATTRIBUTE_SYSTEM //文件是系统的一部分,或是系统专用的.

FILE_ATTRIBUTE_TEMPORARY //文件被使用后。文件系统将努力为（文件的）全部数据的迅迅訪问保持一块内存。暂时文件应当在程序不用时及时删除。

dwFlagAndAttributes能够接受下列标志的随意组合。
FILE_FLAG_WRITE_THROUGH //指示系统通过高速缓存直接写入磁盘，

FILE_FLAG_OVERLAPPED //指示系统初始化对象, 此操作将对进程设置一个引用计数并返回ERROR_IO_PENDING.处理完毕后, 指定对象将被设置为信号状态.

当你指定FILE_FLAG_OVERLAPPED时,读写文件的函数必须指定一个OVERLAPPED结构.

而且，当FILE_FLAG_OVERLAPPED被指定, 程序必须运行重叠參数(指向OVERLAPPED 结构)去进行文件的读写.

这个标志也能够有超过一个操作去运行.

FILE_FLAG_NO_BUFFERING //指示系统不使用高速缓冲区或缓存，当和FILE_FLAG_OVERLAPPED组合,该标志给出最大的异步操作量, 由于I/O不依赖内存管理器的异步操作.然而,一些I/O操作将会执行得长一些,由于数据没有控制在缓存中.

当使用FILE_FLAG_NO_BUFFERING打开文件进行工作时,程序必须达到下列要求:

文件的存取开头的字节偏移量必须是扇区尺寸的整倍数.

文件存取的字节数必须是扇区尺寸的整倍数.比如,假设扇区尺寸是512字节 程序就行读或者写512,1024或者2048字节,但不可以是335,981或者7171 字节.

进行读和写操作的地址必须在扇区的对齐位置,在内存中对齐的地址是扇区 尺寸的整倍数.

一个将缓冲区与扇区尺寸对齐的途径是使用VirtualAlloc函数. 它分配与操作系统 内存页大小的整倍数对齐的内存地址.由于内存页尺寸和扇区尺寸--2都是它们的幂. 这块内存在地址中相同与扇区尺寸大小的整倍数对齐.

程序能够通过调用GetDiskFreeSpace来确定扇区的尺寸.

FILE_FLAG_RANDOM_ACCESS //指定文件是随机訪问,这个标志能够使系统优化文件的缓冲.

FILE_FLAG_SEQUENTIAL_SCAN //指定文件将从头到尾连续地訪问.这个标志能够提示系统优化文件缓冲. 假设程序在随机訪问文件里移动文件指针,优化可能不会发生;然而,正确的操作仍然能够得到保证

指定这个标志能够提高程序以顺序訪问模式读取大文件的性能, 性能的提高在很多 程序读取一些大的顺序文件时是异常明显的.可是可能会有小范围的字节遗漏.

FILE_FLAG_DELETE_ON_CLOSE 指示系统在文件全部打开的句柄关闭后马上删除文件.不仅仅有你能够指定FILE_FLAG_DELETE_ON_CLOSE

假设没有使用FILE_SHARE_DELETE,兴许的打开文件的请求将会失败.

FILE_FLAG_BACKUP_SEMANTICS //WINDOWS NT:指示系统为文件的打开或创建运行一个备份或恢复操作. 系统保证调用进程忽略文件的安全选项,倘若它必须有一个特权.则相关的特权则是SE_BACKUP_NAME和SE_RESTORE_NAME.

你也可以使用这个标志获得一个目录的句柄，一个目录句柄可以象一个文件句柄

一样传给某些Win32函数。

FILE_FLAG_POSIX_SEMANTICS //指明文件符合POSIX标准.这是在MS-DOS与16位Windows下的标准.

FILE_FLAG_OPEN_REPARSE_POINT //指定这个标志制约NTFS分区指针.该标志不可以和CREAT_ALWAYS一起使用.

FILE_FLAG_OPEN_NO_RECALL //指明须要文件数据,可是将继续从远程存储器中接收.它不会将数据存放在本地存储器中.这个标志由远程存储系统或等级存储管理器系统使用.

hTemplateFile

//为GENERIC_READ訪问的模式指定一个句柄到模板文件.模板文件在文件開始创建后提供文件属性和扩展属性.

返回值

//假设函数成功,返回一个打开的指定文件的句柄.假设指定文件在函数调用前已经存在而且dwCreation參数是CREATE_ALWAYS 或者OPEN_ALWAYS,调用GetLastError就会返回ERROR_ALREADY_EXISTS(表示函数成功). 假设函数文件在调用前不存在则会返回0.

//假设函数失败,返会值会是INVALID_HANDLE_VALUE. 很多其它的错误信息能够调用GetLastError来获得.