CcSetLogHandleForFileEx 루틴
CcSetLogHandleForFileEx 루틴은 파일에 대한 로그 핸들을 설정하고 파일 로그에 대한 콜백 함수를 추적합니다.
구문
VOID CcSetLogHandleForFileEx(
_In_ PFILE_OBJECT FileObject,
_In_ PVOID LogHandle,
_In_ PFLUSH_TO_LSN FlushToLsnRoutine,
_In_ PQUERY_LOG_USAGE QueryLogUsageRoutine
);
매개 변수
FileObject [in] 로그 핸들을 저장할 파일의 파일 개체에 대한 포인터입니다.
LogHandle [in] 저장할 로그 핸들에 대한 포인터입니다.
FlushToLsnRoutine [in] 이 파일에 대한 버퍼를 플러시하기 전에 호출할 로그 파일 플러시 콜백 루틴에 대한 포인터입니다. 이 루틴은 로그 파일이 플러시되는 BCB(버퍼 제어 블록)에 대한 가장 최근의 LSN(논리 시퀀스 번호)으로 플러시되도록 하기 위해 호출됩니다. 이 루틴은 다음과 같이 선언됩니다.
typedef
VOID (*PFLUSH_TO_LSN) (
IN PVOID LogHandle,
IN LARGE_INTEGER Lsn
);
이 클라이언트를 식별하는 데 사용되는 불투명 구조체에 대한 포인터입니다.
이 콜백 루틴에서 반환 시 디스크에 있어야 하는 LSN입니다.
QueryLogUsageRoutine [in] 이 파일에 대한 로그 사용 비율을 검색하기 위해 호출할 클라이언트 콜백 루틴에 대한 포인터입니다. 이 루틴은 더티 페이지의 쓰기를 시작하기 위해 임계값이 충족되는지 확인하기 위해 호출됩니다. 이 루틴은 다음과 같이 선언됩니다.
typedef
VOID (*PQUERY_LOG_USAGE) (
IN PVOID LogHandle,
OUT PUSHORT PercentageFull
);
이 클라이언트를 식별하는 데 사용되는 불투명 구조체에 대한 포인터입니다.
로그 사용률을 나타내는 0에서 100 사이의 값입니다.
반환 값
None
설명
CcSetLogHandleForFileEx 는 CcGetDirtyPages에 대한 후속 호출에 사용할 파일의 로그 핸들을 설정합니다.
FlushToLsnRoutine 및 QueryLogUsageRoutine에 대한 콜백이 필요합니다. 이러한 값은 NULL이 아니어야 합니다.
요구 사항
대상 플랫폼 |
유니버설 |
버전 |
Windows 8 이상에서 사용할 수 있습니다. |
헤더 |
Ntifs.h(Ntifs.h 포함) |
Library |
NtosKrnl.lib |
DLL |
NtosKrnl.exe |
IRQL |
모든 수준 |