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,即使它以同步方式完成也一樣。
當 CLFS 管理要求客戶端前進其記錄尾時,會呼叫 ClfsAdvanceTailCallback 函式。
ClfsAdvanceTailCallback 函式在傳回之前,必須執行最少的處理量。 例如,ClfsAdvanceTailCallback 函式可能會遵循下列程式:
- 如果無法處理要求,請傳回錯誤狀態。
- 如果可以處理要求,請建立工作專案並排入佇列,以執行行動用戶端結尾所需的動作,然後傳回STATUS_PENDING。 如需佇列背景工作線程的詳細資訊,請參閱 系統背景工作線程。
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Server 2003 R2、Windows Vista 和更新版本的 Windows 支援。 |
目標平臺 | 桌面 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
IRQL | 在 IRQL <= APC_LEVEL 呼叫 |