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
*ppvRestartBuffer가 가리키는 버퍼의 크기(바이트)를 수신하는 ULONG 형식 변수에 대한 포인터입니다. 이는 읽은 다시 시작 레코드의 데이터 버퍼 길이입니다.
[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 |