функция обратного вызова 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 для блокировки файлов диапазона байтов.

Чтобы указать эту подпрограмму, устаревший фильтр передает указатель на подпрограмму в качестве параметра CompleteLockIrpRoutine для FsRtlAllocateFileLock или FsRtlInitializeFileLock.

Если устаревший фильтр задает процедуру CompleteLockIrpRoutine для блокировки файла, система вызывает эту подпрограмму при завершении операции IRP_MJ_LOCK_CONTROL блокировки файла.

Требования

См. также

FsRtlAllocateFileLock

FsRtlCheckLockForReadAccess

FsRtlCheckLockForWriteAccess

FsRtlFreeFileLock

FsRtlInitializeFileLock

FsRtlProcessFileLock

FsRtlUninitializeFileLock

IRP_MJ_LOCK_CONTROL

PUNLOCK_ROUTINE