ccCopyReadEx 函数 (ntifs.h)

项目
02/29/2024

CcCopyReadEx 例程将数据从缓存的文件复制到用户缓冲区。操作的 I/O 字节计数将计入发出线程。

语法

BOOLEAN CcCopyReadEx(
  [in]  PFILE_OBJECT     FileObject,
  [in]  PLARGE_INTEGER   FileOffset,
  [in]  ULONG            Length,
  [in]  BOOLEAN          Wait,
  [out] PVOID            Buffer,
  [out] PIO_STATUS_BLOCK IoStatus,
  [in]  PETHREAD         IoIssuerThread
);

参数

[in] FileObject

指向要从中读取数据的缓存文件的文件对象的指针。

[in] FileOffset

指向变量的指针，该变量指定缓存文件中的起始字节偏移量。

[in] Length

要读取的数据的长度（以字节为单位）。

[in] Wait

如果调用方可以置于等待状态，直到复制所有数据，则设置为 TRUE;否则设置为 FALSE。

[out] Buffer

指向要将数据复制到其中的缓冲区的指针。

[out] IoStatus

指向调用方分配的结构的指针，该结构接收最终完成状态和有关操作的信息。如果未成功复制所有数据， IoStatus.Information 将包含已复制的实际字节数。

[in] IoIssuerThread

发出读取请求的线程。对于启用了磁盘 I/O 记帐的文件系统，这是向 I/O 收费的线程。如果 IoIssuerThread 为 NULL，则 I/O 会向当前线程收费。

返回值

如果成功复制数据， CcCopyReadEx 例程将返回 TRUE，否则返回 FALSE。

注解

如果 Wait 为 TRUE，则保证 CcCopyReadEx 完成复制请求并返回 TRUE。如果缓存文件的所需页已驻留在内存中，则会立即复制数据，并且不会发生阻塞。如果任何所需的页面不是驻留页，调用方将处于等待状态，直到所有必需的页面都已驻留，并且可以复制数据。

如果 Wait 为 FALSE， 则 CcCopyReadEx 将拒绝阻止，并且如果缓存文件的所需页尚未驻留在内存中，则将返回 FALSE。

FileOffset 加 Length 必须小于或等于缓存文件的大小，否则将发生断言失败。

如果发生任何故障， CcCopyReadEx 将针对该特定失败引发状态异常。例如，如果发生池分配失败， CcCopyReadEx 将引发异常 ，STATUS_INSUFFICIENT_RESOURCES 状态;如果发生 I/O 错误， CcCopyReadEx 将引发 I/O 错误的状态异常。因此，若要在发生故障时获得控制权，驱动程序应在 try-except 或try-finally 语句中包装对 CcCopyReadEx 的调用。

若要缓存文件，请使用 CcInitializeCacheMap。

要求

要求	值
最低受支持的客户端	Windows 8
目标平台	通用
标头	ntifs.h (包括 Ntifs.h、FltKernel.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL