ClfsReadPreviousRestartArea 函式 (wdm.h)
ClfsReadPreviousRestartArea 例程會讀取先前的重新啟動記錄,相對於讀取內容中的當前記錄。
語法
CLFSUSER_API NTSTATUS ClfsReadPreviousRestartArea(
[in] PVOID pvReadContext,
[out] PVOID *ppvRestartBuffer,
[out] PULONG pcbRestartBuffer,
[out] PCLFS_LSN plsnRestart
);
參數
[in] pvReadContext
先前呼叫 ClfsReadRestartArea 取得之讀取內容的指標。
[out] ppvRestartBuffer
變數的指標,可接收讀取之重新啟動記錄之數據緩衝區的指標。
[out] pcbRestartBuffer
ULONG 型別變數的指標,可接收 *ppvRestartBuffer 所指向之緩衝區的大小,以位元組為單位。 這是讀取之重新啟動記錄的數據緩衝區長度。
[out] plsnRestart
接收已讀取之重新啟動記錄先前 LSN 之CLFS_LSN 結構的指標。
傳回值
ClfsReadPreviousRestartArea 會在成功時傳回STATUS_SUCCESS;否則,它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。 如果沒有先前的重新啟動區域,傳回值會STATUS_LOG_START_OF_LOG。
備註
如需CLFS概念和術語的說明,請參閱 一般記錄檔系統。
如需從 CLFS 數據流讀取記錄的相關信息,請參閱從 CLFS 讀取數據記錄 Stream 和從 CLFS 讀取重新啟動記錄 Stream。
讀取內容不是安全線程。 用戶端負責串行化讀取內容的存取權。
用戶端會呼叫 ClfsWriteRestartArea,將重新啟動記錄附加至 CLFS 記錄。
透過 ReadPreviousLogRestartArea 例程,用戶端可以實作模糊檢查點的形式。 例如,檢查點狀態可能包含以兩個或多個重新啟動記錄分隔的記錄檔記錄。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows 中使用。 |
目標平台 | 桌面 |
標頭 | wdm.h (包含 Wdm.h) |
程式庫 | Clfs.lib |
Dll | Clfs.sys |
IRQL | <= APC_LEVEL |