ClfsReadNextLogRecord 函式 （wdm.h）
ClfsReadNextLogRecord 例程會讀取序列中的下一筆記錄，相對於讀取內容中的目前記錄。
語法
CLFSUSER_API NTSTATUS ClfsReadNextLogRecord(
[in, out] PVOID pvReadContext,
[out] PVOID *ppvBuffer,
[out] PULONG pcbBuffer,
[in, out] PCLFS_RECORD_TYPE peRecordType,
[in, optional] PCLFS_LSN plsnUser,
[out] PCLFS_LSN plsnUndoNext,
[out] PCLFS_LSN plsnPrevious,
[out] PCLFS_LSN plsnRecord
);
參數
[in, out] pvReadContext
呼叫 clfsReadLogRecord 或 ClfsReadRestartArea取得呼叫者先前取得之讀取內容的指標。
[out] ppvBuffer
變數的指標，接收包含記錄數據的緩衝區指標。
[out] pcbBuffer
ULONG 型別變數的指標，接收由 *ppvBuffer 所指向之緩衝區的大小，以位元組為單位。 這是記錄讀取的數據緩衝區長度。
[in, out] peRecordType
類型為 CLFS_RECORD_TYPE 之變數的指標。 呼叫端必須將此參數設定為下列其中一個值。
| 價值 | 將讀取的記錄 |
|---|---|
| ClfsDataRecord | 下一個數據記錄。 |
| ClfsRestartRecord | 下一個重新啟動記錄。 |
| ClfsClientRecord | 下一筆記錄是數據記錄或重新啟動記錄。 |
[in, optional] plsnUser
CLFS_LSN 結構的指標，提供要讀取之記錄的 LSN。 指定的記錄會讀取，而不是根據讀取內容的模式讀取的記錄（ClfsContextUndoNext、ClfsContextPrevious或 ClfsContextForward） 讀取內容 （pvReadContext）。 plsnUser 中提供的 LSN 必須小於讀取內容的目前 LSN。 此參數可以是 NULL 。
[out] plsnUndoNext
CLFS_LSN 結構的指標，接收讀取之記錄的復原下一個 LSN。
[out] plsnPrevious
CLFS_LSN 結構的指標，這個結構會接收先前讀取之記錄的 LSN。
[out] plsnRecord
CLFS_LSN 結構的指標，這個結構會接收讀取之記錄的 LSN。
傳回值
ClfsReadNextLogRecord 如果成功，就會傳回STATUS_SUCCESS;否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。
言論
如需 CLFS 概念和術語的說明，請參閱 Common Log File System。
如需從 CLFS 資料串流讀取記錄的相關信息，請參閱 從 CLFS 資料串流讀取資料記錄 和從 CLFS 資料流讀取重新啟動記錄 。
讀取內容不是安全線程。 用戶端負責串行化讀取內容的存取權。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows。 |
| 目標平臺 | 桌面 |
| 標頭 | wdm.h （包括 Wdm.h） |
| 連結庫 | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |