术语 | setfileiooverlappedrange |
释义 | SetFileIoOverlappedRange 语法: C++ BOOL WINAPI SetFileIoOverlappedRange( __in HANDLE FileHandle, __in PUCHAR OverlappedRangeStart, __in ULONG Length ); SetFileIoOverlappedRange功能 协会与指定的文件句柄的虚拟地址范围。这表明,内核应进一步优化异步I / O与此范围内重叠结构的要求。重叠的范围被锁定在内存中,然后锁定该文件时关闭。经过范围与一个文件句柄,它不能脱离。 参数 文件句柄 [in] 阿处理该文件。 OverlappedRangeStart [in] 范围为起始地址。 Length [in] 该范围的长度,以字节为单位。 返回值 如果成功则返回非零或否则为0。 为了获得更多错误信息,调用GetLastError。 备注 SetFileIoOverlappedRange可以用来提高应用程序性能问题的异步大量缓冲I / O,并使用重叠结构的定义范围。 Because this range of structures is locked in memory, the kernel can avoid acquiring certain locks when updating the overlapped structures with the results of the I/O request. SetFileIoOverlappedRange需要调用者有SeLockMemoryPrivilege访问权限。 这个函数有没有缓冲和同步I效果/澳 要编译的应用程序使用此函数,定义为0x0501或更高_WIN32_WINNT宏。有关详细信息,请参阅使用Windows头。 要求: client最低支持Vista server最低支持 Windows Server 2008 HeaderWinBase.h LibraryKernel32.lib DLLKernel32.dll 参见 文件管理函数 如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com) 生成日期:2009年9月3日 ==英文原文==SetFileIoOverlappedRange Function Associates a virtual address range with the specified file handle. This indicates that the kernel should optimize any further asynchronous I/O requests with overlapped structures inside this range. The overlapped range is locked in memory, and then unlocked when the file is closed. After a range is associated with a file handle, it cannot be disassociated. Syntax C++ BOOL WINAPI SetFileIoOverlappedRange( __in HANDLE FileHandle, __in PUCHAR OverlappedRangeStart, __in ULONG Length ); Parameters FileHandle [in] A handle to the file. OverlappedRangeStart [in] The starting address for the range. Length [in] The length of the range, in bytes. Return Value Returns nonzero if successful or zero otherwise. To get extended error information, call GetLastError . Remarks SetFileIoOverlappedRange can be used to improve performance in an application that issues a high number of asynchronous unbuffered I/O and uses a defined range of overlapped structures. Because this range of structures is locked in memory, the kernel can avoid acquiring certain locks when updating the overlapped structures with the results of the I/O request. SetFileIoOverlappedRange requires the caller to have the SeLockMemoryPrivilege access privilege. This function has no effect on buffered and synchronous I/O. To compile an application that uses this function, define the _WIN32_WINNT macro as 0x0501 or later. For more information, see Using the Windows Headers . Requirements Minimum supported clientWindows Vista Minimum supported serverWindows Server 2008 HeaderWinBase.h LibraryKernel32.lib DLLKernel32.dll See Also File Management Functions Send comments about this topic to Microsoft Build date: 9/3/2009 ==原始网址==http://msdn.microsoft.com/en-us/library/aa365540(VS.85).aspx\n |
随便看 |
|
windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。