PCOMPLETE_LOCK_IRP_ROUTINE回呼函式 (ntifs.h)

文件系統篩選驅動程式 (舊版篩選) 可以將 PCOMPLETE_LOCK_IRP_ROUTINE類型的例程註冊為篩選條件的 CompleteLockIrpRoutine 回呼。

語法

PCOMPLETE_LOCK_IRP_ROUTINE PcompleteLockIrpRoutine;

NTSTATUS PcompleteLockIrpRoutine(
  PVOID Context,
  PIRP Irp
)
{...}

參數

Context

[in]傳遞至 FsRtlProcessFileLock 的內容指標。

Irp

[in]正在完成之檔案鎖定的 IRP IRP_MJ_LOCK_CONTROL 要求。 鎖定要求類型將是下列其中一項:

  • IRP_MN_LOCK
  • IRP_MN_UNLOCK_ALL
  • IRP_MN_UNLOCK_ALL_BY_KEY
  • IRP_MN_UNLOCK_SINGLE

傳回值

這個例程會傳回STATUS_SUCCESS或適當的NTSTATUS值。 如果它傳回不是成功碼的NTSTATUS值,則會從檔案中移除檔案鎖定。

備註

文件系統篩選驅動程式 (舊版篩選) 可以選擇性地將PCOMPLETE_LOCK_IRP_ROUTINE型別例程指定為位元組範圍檔案鎖定的舊版篩選器 CompleteLockIrpRoutine 例程。

若要指定此例程,舊版篩選會將指標傳遞至例程做為 FsRtlAllocateFileLockFsRtlInitializeFileLockCompleteLockIrpRoutine 參數。

如果舊版篩選器為檔案鎖定指定 CompleteLockIrpRoutine 例程,則系統會在完成檔案鎖定 的IRP_MJ_LOCK_CONTROL 作業時呼叫此例程。

規格需求

需求
標頭 ntifs.h
IRQL APC_LEVEL

另請參閱

FsRtlAllocateFileLock

FsRtlCheckLockForReadAccess

FsRtlCheckLockForWriteAccess

FsRtlFreeFileLock

FsRtlInitializeFileLock

FsRtlProcessFileLock

FsRtlUninitializeFileLock

IRP_MJ_LOCK_CONTROL

PUNLOCK_ROUTINE