Поделиться через


Функция FsRtlAllocateFileLock (ntifs.h)

Подпрограмма FsRtlAllocateFileLock выделяет и инициализирует новую структуру FILE_LOCK.

Синтаксис

PFILE_LOCK FsRtlAllocateFileLock(
  [in, optional] PCOMPLETE_LOCK_IRP_ROUTINE CompleteLockIrpRoutine,
  [in, optional] PUNLOCK_ROUTINE            UnlockRoutine
);

Параметры

[in, optional] CompleteLockIrpRoutine

Указатель на PCOMPLETE_LOCK_IRP_ROUTINE типизированной подпрограммы обратного вызова, вызываемой при выполнении запроса IRP_MJ_LOCK_CONTROL . Этот параметр является необязательным и может иметь значение NULL.

[in, optional] UnlockRoutine

Указатель на PUNLOCK_ROUTINE типизированной процедуры обратного вызова, вызываемой при разблокировке диапазона байтов. Этот параметр является необязательным и может иметь значение NULL.

Возвращаемое значение

FsRtlAllocateFileLock возвращает указатель на только что выделенную FILE_LOCK структуру.

Комментарии

FsRtlAllocateFileLock выделяет новую структуру FILE_LOCK из страничного пула и инициализирует ее.

Минифильтры должны вызывать FltAllocateFileLock вместо FsRtlAllocateFileLock.

Требования

Требование Значение
Минимальная версия клиента Windows 2000
Целевая платформа Универсальное
Верхняя часть ntifs.h (включая Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL
Правила соответствия DDI HwStorPortProhibitedDIs(storport), SpNoWait(storport), StorPortStartIo(storport)

См. также раздел

FltAllocateFileLock

FsRtlAreThereCurrentFileLocks

FsRtlCheckLockForReadAccess

FsRtlCheckLockForWriteAccess

FsRtlFastCheckLockForRead

FsRtlFastCheckLockForWrite

FsRtlFastLock

FsRtlFastUnlockAll

FsRtlFastUnlockAllByKey

FsRtlFastUnlockSingle

FsRtlGetNextFileLock

FsRtlInitializeFileLock

FsRtlProcessFileLock

FsRtlUninitializeFileLock

IRP_MJ_LOCK_CONTROL

PCOMPLETE_LOCK_IRP_ROUTINE

PUNLOCK_ROUTINE