PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK回调函数 (wdm.h)

  • 项目

ClfsLogGrowthCompleteCallback 函数实现在以前已满的日志中释放空间时客户端将执行的操作。

语法

PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK PclfsClientLffHandlerCompleteCallback;

void PclfsClientLffHandlerCompleteCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] NTSTATUS OperationStatus,
  [in] BOOLEAN LogIsPinned,
  [in] PVOID ClientData
)
{...}

参数

[in] LogFile

指向 LOG_FILE_OBJECT 结构的指针，该结构表示其日志已完成增长的 CLFS 日志流。

[in] OperationStatus

客户端处理日志文件已满条件的早期请求的状态。 这可以是STATUS_SUCCESS或错误状态，指示请求无法成功完成的原因。

[in] LogIsPinned

如果 为 TRUE，则指定日志尾部当前已固定;如果日志尾部未固定，则为 FALSE 。

[in] ClientData

指向客户端提供的信息的指针。

返回值

无

备注

由于对 ClfsMgmtHandleLogFileFull 的调用以异步方式完成，因此在处理日志文件完整条件时客户端将执行的任何操作都属于 ClfsLogGrowthCompleteCallback 函数。

如果对 返回的 ClfsMgmtHandleLogFileFull 例程的调用返回STATUS_PENDING，则在操作完成时将调用 ClfsLogGrowthCompleteCallback 函数。 如果返回了不同的状态，则不会调用 ClfsLogGrowthCompleteCallback 函数。

ClfsLogGrowthCompleteCallback 函数在返回之前应仅执行最少量的处理。 例如， ClfsLogGrowthCompleteCallback 函数可能遵循以下过程：

  1. 如果 OperationStatus 参数的值是错误状态，则 返回 。
  2. 如果 OperationStatus 参数的值STATUS_SUCCESS，请创建工作项并将其排队，以通知客户端它可以继续处理。
当客户端使用 ClfsMgmtRegisterManagedClient 例程向 CLFS 管理注册时，客户端会提供指向 ClfsLogGrowthCompleteCallback 函数的指针，以及调用此函数时将作为参数传递给 ClfsLogGrowthCompleteCallback 函数的自定义数据。

要求

要求 值
最低受支持的客户端 在 Windows Server 2003 R2、Windows Vista 和更高版本的 Windows 中受支持。
目标平台 桌面
标头 wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
IRQL 在 IRQL <= APC_LEVEL 调用

另请参阅

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient