PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE 콜백 함수(fltkernel.h)

미니필터 드라이버는 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

추가 정보

FILE_LOCK

FltAllocateFileLock

FltCheckLockForReadAccess

FltCheckLockForWriteAccess

FltFreeFileLock

FltInitializeFileLock

FltProcessFileLock

FltUninitializeFileLock

IRP_MJ_LOCK_CONTROL

PUNLOCK_ROUTINE