PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE 콜백 함수(fltkernel.h)

아티클
12/21/2024

미니 필터 드라이버는 FILE_LOCK 구조에 대한 미니 필터 드라이버의 CompleteLockCallbackDataRoutine 콜백 루틴으로 PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE 형식의 루틴을 등록할 수 있습니다.

통사론

PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE PfltCompleteLockCallbackDataRoutine;

NTSTATUS PfltCompleteLockCallbackDataRoutine(
  [in, optional] PVOID Context,
  [in]           PFLT_CALLBACK_DATA CallbackData
)
{...}

매개 변수

[in, optional] Context

FltProcessFileLock전달된 컨텍스트 포인터입니다.

[in] CallbackData

완료되는 IRP_MJ_LOCK_CONTROL 작업의 콜백 데이터(FLT_CALLBACK_DATA) 구조체에 대한 포인터입니다. 잠금 요청 유형은 다음 중 하나입니다.

IRP_MN_LOCK
IRP_MN_UNLOCK_ALL
IRP_MN_UNLOCK_ALL_BY_KEY
IRP_MN_UNLOCK_SINGLE

반환 값

이 루틴은 STATUS_SUCCESS 또는 적절한 NTSTATUS 값을 반환합니다. 성공 코드가 아닌 NTSTATUS 값을 반환하면 파일 잠금이 파일에서 제거됩니다.

발언

미니 필터 드라이버는 선택적으로 바이트 범위 파일 잠금에 대한 미니 필터 드라이버의 CompleteLockCallbackDataRoutine 루틴으로 PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE 형식의 루틴을 지정할 수 있습니다. 이 루틴을 지정하기 위해 미니 필터 드라이버는 FltAllocateFileLock대한 CompleteLockCallbackDataRoutine 매개 변수로 루틴에 대한 포인터를 전달합니다.

파일 잠금에 대한 IRP_MJ_LOCK_CONTROL 작업을 완료할 때 필터 관리자는 지정된 경우 이 루틴을 미니 필터에 대한 알림으로 호출합니다.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows XP SP2
지원되는 최소 서버	Windows Server 2003 SP1
대상 플랫폼	바탕 화면
헤더	fltkernel.h(Fltkernel.h 포함)
IRQL	<=APC_LEVEL