通过

CcSetFileSizesEx 函数 （ntifs.h）

  • 项目

CcSetFileSizesEx 例程更新缓存文件的缓存映射和节对象，其大小已更改。

语法

NTSTATUS CcSetFileSizesEx(
  PFILE_OBJECT   FileObject,
  PCC_FILE_SIZES FileSizes
);

参数

FileObject

[in]指向缓存文件的文件对象的指针。

FileSizes

[in]指向包含新文件大小信息的 CC_FILE_SIZES 结构的指针。

返回值

CcSetFileSizesEx 在文件大小成功更改时返回STATUS_SUCCESS;如果需要清除，则清除成功。 否则，它将返回非成功 NSTATUS 代码（如STATUS_INSUFFICIENT_RESOURCES），并可能会引发状态异常。

关于引发错误状态异常：

  • 如果操作导致 CcSetFileSizesEx 刷新和/或清除文件，CcSetFileSizesEx 不会引发错误;它只返回刷新或清除操作的适当非成功 NTSTATUS 代码。

  • 如果操作导致 CcSetFileSizesEx 扩展该部分，则 CcSetFileSizesEx 将引发此扩展期间遇到的任何错误。

言论

文件系统必须调用 CcSetFileSizesEx，以在对缓存文件进行以下更改之一时更新缓存管理器数据结构：

  • 其分配大小增加。

  • 其有效数据长度会减少。

  • 其有效数据长度由非缓存的 I/O 操作增加。

  • 其文件大小增加或减少。

如果操作导致 CcSetFileSizesEx 扩展节并发生故障，CcSetFileSizesEx 将引发该特定失败的状态异常。 例如，如果池分配失败，CcSetFileSizesEx 将引发STATUS_INSUFFICIENT_RESOURCES异常。 因此，若要控制是否发生故障，驱动程序应在 try-try-finally 语句中包装对 CcSetFileSizesEx 的调用。

文件系统必须确保缓存映射有效，并在此调用期间保持此状态。

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

若要获取缓存文件的大小，请将 FileObject 传递给 CcGetFileSizePointer。

要求

要求 价值
标头 ntifs.h

另请参阅

CcInitializeCacheMap

CcSetCacheFileSizes