通过

CcCopyWrite 函数 （ntifs.h）

  • 项目

CcCopyWrite 例程将数据从用户缓冲区复制到缓存的文件。

语法

BOOLEAN CcCopyWrite(
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER FileOffset,
  [in] ULONG          Length,
  [in] BOOLEAN        Wait,
  [in] PVOID          Buffer
);

参数

[in] FileObject

指向要向其写入数据的缓存文件的文件对象的指针。

[in] FileOffset

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

[in] Length

要写入的数据的长度（以字节为单位）。

[in] Wait

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

[in] Buffer

指向要从中复制数据的缓冲区的指针。

返回值

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

言论

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

如果 WaitFALSE，CcCopyWrite 将拒绝阻止，并且如果缓存文件所需的页面尚未驻留在内存中，或者文件对象上设置了FO_WRITE_THROUGH标志，则返回 FALSE。

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

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

要求

要求 价值
最低支持的客户端 Windows 2000
目标平台 普遍
标头 ntifs.h（包括 Ntifs.h、FltKernel.h）
库 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另请参阅

CcInitializeCacheMap