PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK 콜백 함수(wdm.h)

  • 아티클

ClfsLogGrowthCompleteCallback 함수는 이전에 가득 찼던 로그에서 공간이 해제될 때 클라이언트가 수행할 작업을 구현합니다.

구문

PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK PclfsClientLffHandlerCompleteCallback;

void PclfsClientLffHandlerCompleteCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] NTSTATUS OperationStatus,
  [in] BOOLEAN LogIsPinned,
  [in] PVOID ClientData
)
{...}

매개 변수

[in] LogFile

로그 증가가 완료된 CLFS 로그 스트림을 나타내는 LOG_FILE_OBJECT 구조체에 대한 포인터입니다.

[in] OperationStatus

로그 파일 전체 조건을 처리하기 위한 클라이언트의 이전 요청 상태. 이는 요청을 성공적으로 완료할 수 없는 이유를 나타내는 STATUS_SUCCESS 또는 오류 상태.

[in] LogIsPinned

TRUE이면 로그 꼬리가 현재 고정되도록 지정합니다. 로그 꼬리가 고정되지 않은 경우 FALSE입니다.

[in] ClientData

클라이언트에서 제공하는 정보에 대한 포인터입니다.

반환 값

없음

설명

ClfsMgmtHandleLogFileFull에 대한 호출은 비동기적으로 완료되므로 로그 파일 전체 조건이 처리될 때 클라이언트가 수행하는 모든 작업은 ClfsLogGrowthCompleteCallback 함수에 속합니다.

반환된 ClfsMgmtHandleLogFileFull 루틴에 대한 호출이 STATUS_PENDING 반환되면 작업이 완료될 때 ClfsLogGrowthCompleteCallback 함수가 호출됩니다. 다른 상태 반환된 경우 ClfsLogGrowthCompleteCallback 함수가 호출되지 않습니다.

ClfsLogGrowthCompleteCallback 함수는 반환하기 전에 최소한의 처리만 수행해야 합니다. 예를 들어 ClfsLogGrowthCompleteCallback 함수는 다음 절차를 따를 수 있습니다.

  1. OperationStatus 매개 변수의 값이 오류 상태 경우 를 반환합니다.
  2. OperationStatus 매개 변수 값이 STATUS_SUCCESS 경우 작업 항목을 만들고 큐에 대기하여 클라이언트에 처리를 다시 시작할 수 있음을 알립니다.
클라이언트가 CLFS 관리에 등록하기 위해 ClfsMgmtRegisterManagedClient 루틴을 사용하는 경우 클라이언트는 ClfsLogGrowthCompleteCallback 함수에 대한 포인터와 이 함수가 호출될 때 ClfsLogGrowthCompleteCallback 함수에 매개 변수로 전달될 사용자 지정 데이터를 모두 제공합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Server 2003 R2, Windows Vista 및 이후 버전의 Windows에서 지원됩니다.
대상 플랫폼 데스크톱
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
IRQL IRQL <= APC_LEVEL 호출

추가 정보

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient