SetFileIoOverlappedRange 函数 (fileapi.h)

将虚拟地址范围与指定的文件句柄相关联。这表示内核应优化此范围内具有重叠结构的任何进一步异步 I/O 请求。重叠的范围在内存中锁定，然后在文件关闭时解锁。区域与文件句柄关联后，无法取消关联。

语法

BOOL SetFileIoOverlappedRange(
  [in] HANDLE FileHandle,
  [in] PUCHAR OverlappedRangeStart,
  [in] ULONG  Length
);

[in] FileHandle

文件的句柄。

必须使用 FILE_READ_ATTRIBUTES 访问权限打开此文件句柄。

[in] OverlappedRangeStart

范围的起始地址。

[in] Length

范围的长度（以字节为单位）。

如果成功，则返回非零值，否则返回零。

要获得更多的错误信息，请调用 GetLastError。

SetFileIoOverlappedRange 可用于在发出大量异步无缓冲区 I/O 并使用定义的重叠结构范围的应用程序中提高性能。由于此结构范围在内存中被锁定，因此内核可以在使用 I/O 请求结果更新重叠结构时避免获取某些锁。

SetFileIoOverlappedRange 要求调用方具有 SeLockMemoryPrivilege 访问权限。

此函数对缓冲 I/O 和同步 I/O 没有影响。

在 Windows 8 和 Windows Server 2012 中，此函数由以下技术支持。

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	fileapi.h (包括 Windows.h、WinBase.h)
Library	Kernel32.lib
DLL	Kernel32.dll