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 函数可能遵循此过程:
- 如果无法处理请求,则返回错误状态。
- 如果可以处理请求,请创建工作项并将其排队以执行移动客户端尾部所需的操作,然后返回STATUS_PENDING。 有关排队工作线程的详细信息,请参阅 系统工作线程。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Windows Server 2003 R2、Windows Vista 和更高版本的 Windows 中受支持。 |
目标平台 | 桌面 |
标头 | wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h) |
IRQL | 在 IRQL <= APC_LEVEL 调用 |