通过

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

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

[in] TargetLsn

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

[in] ClientData

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

返回值

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

言论

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

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