PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK回调函数 (wdm.h)

  • 项目

ClfsAdvanceTailCallback 函数将基本日志序列号 (LSN) 客户端日志。

语法

PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK PclfsClientAdvanceTailCallback;

NTSTATUS PclfsClientAdvanceTailCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] PCLFS_LSN TargetLsn,
  [in] PVOID ClientData
)
{...}

参数

[in] LogFile

指向 LOG_FILE_OBJECT 结构的指针，该结构表示其尾部应是高级的 CLFS 日志流。

[in] TargetLsn

指向 CLFS_LSN 结构的指针，该结构包含客户端应将其尾部推进到或超出的 LSN。

[in] ClientData

指向客户端提供的信息的指针。 在 CLFS_MGMT_CLIENT_REGISTRATION 结构的 AdvanceTailCallbackData 成员中指定此数据。

返回值

ClfsAdvanceTailCallback 函数应返回STATUS_PENDING或错误状态。 返回值 STATUS_PENDING 指示移动客户端日志尾部的请求将以异步方式完成。 ClfsMgmtAdvanceTailCallback 函数不得返回STATUS_SUCCESS，即使它同步完成。

注解

ClfsAdvanceTailCallback 函数在 CLFS 管理请求客户端推进其日志尾部时调用。

ClfsAdvanceTailCallback 函数在返回之前只能执行最少量的处理。 例如， ClfsAdvanceTailCallback 函数可能遵循此过程：

  1. 如果无法处理请求，则返回错误状态。
  2. 如果可以处理请求，请创建工作项并将其排队以执行移动客户端尾部所需的操作，然后返回STATUS_PENDING。 有关排队工作线程的详细信息，请参阅 系统工作线程。
当客户端调用 ClfsMgmtRegisterManagedClient 例程以注册 CLFS 管理时，客户端会提供指向 ClfsAdvanceTailCallback 函数的指针，以及调用此函数时将作为参数传递给 ClfsAdvanceTailCallback 函数的自定义数据。

要求

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

另请参阅

CLFS_MGMT_CLIENT_REGISTRATION

ClfsAdvanceLogBase

ClfsMgmtRegisterManagedClient

ClfsMgmtTailAdvanceFailure