FsRtlMdlReadEx 函数 (ntifs.h)
FsRtlMdlReadEx 例程执行快速缓存的 MDL 读取。 如果未缓存请求的数据,则例程将还原为基于 IRP 的 MDL 读取操作。
语法
NTSTATUS FsRtlMdlReadEx(
[in] PFILE_OBJECT FileObject,
[in] PLARGE_INTEGER FileOffset,
[in] ULONG Length,
[in] ULONG LockKey,
[out] PMDL *MdlChain,
[out] PIO_STATUS_BLOCK IoStatus
);
参数
[in] FileObject
指向文件对象的指针。
[in] FileOffset
指向变量的指针,该变量指定保存数据的缓存文件中的起始字节偏移量。
[in] Length
要从缓存中读取的数据的长度(以字节为单位)。
[in] LockKey
一个值,该值与要锁定的字节范围相关联。 如果要锁定的范围与已用非排他性锁锁定的另一个范围重叠,或者要读取的范围是已以非独占方式锁定的另一个范围的子范围,则此参数中的值必须是该非独占锁的键。该锁必须由调用线程的父进程持有。 否则,此参数无效。
[out] MdlChain
变量的地址,该变量接收指向内存描述符列表的链接列表的指针, (MDL) 。 在调用 FsRtlMdlReadEx 之前,MdlChain 必须初始化为 NULL。
[out] IoStatus
指向 IO_STATUS_BLOCK 结构的指针,该结构在输出中包含传输状态。 如果操作成功, 则 IoStatus.Status 设置为 STATUS_SUCCESS。 否则,它将设置为相应的 NTSTATUS 错误代码。 IoStatus.Information 设置为例程成功锁定的实际字节数。
返回值
FsRtlMdlReadEx 返回 STATUS_SUCCESS 或适当的 NTSTATUS 值,如以下值之一:
返回代码 | 说明 |
---|---|
STATUS_INSUFFICIENT_RESOURCES | 无法分配基于 IRP 的读取的 IRP。 |
注解
如果文件系统提供快速 I/ O,FsRtlMdlReadEx 例程将绕过常用的 IRP 读取机制,并返回内存描述符列表的链接列表 (MDL) ,调用方可以使用该列表直接访问缓存的文件数据。 此操作不会复制或缓冲数据,因此比正常读取要快得多。 如果未启用快速 I/ O,FsRtlMdlReadEx 将生成基于 IRP 的同步 MDL 读取,并从请求返回 MDL。
MDL 描述的页面在内存中锁定,但不在系统空间中映射。 调用方可以通过调用 MmGetSystemAddressForMdlSafe 来执行此映射。
与 CcMdlRead 类似, FsRtlMdlReadEx 例程锁定包含缓存文件数据的页面,以防止系统将这些页交换到页面文件。 在调用方调用 CcMdlReadComplete 例程之前,页面在内存中保持锁定状态。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 |
目标平台 | 通用 |
标头 | ntifs.h (包括 Ntifs.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |