Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The FsRtlAllocateFileLock routine allocates and initializes a new FILE_LOCK structure.
Syntax
PFILE_LOCK FsRtlAllocateFileLock(
[in, optional] PCOMPLETE_LOCK_IRP_ROUTINE CompleteLockIrpRoutine,
[in, optional] PUNLOCK_ROUTINE UnlockRoutine
);
Parameters
[in, optional] CompleteLockIrpRoutine
A pointer to a PCOMPLETE_LOCK_IRP_ROUTINE-typed callback routine to be called when an IRP_MJ_LOCK_CONTROL request is completed. This parameter is optional and can be NULL.
[in, optional] UnlockRoutine
A pointer to a PUNLOCK_ROUTINE-typed callback routine to be called when the byte range is unlocked. This parameter is optional and can be NULL.
Return value
FsRtlAllocateFileLock returns a pointer to the newly allocated FILE_LOCK structure.
Remarks
FsRtlAllocateFileLock allocates a new FILE_LOCK structure from paged pool and initializes it.
Minifilters should call FltAllocateFileLock instead of FsRtlAllocateFileLock.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 |
| Target Platform | Universal |
| Header | ntifs.h (include Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
| DDI compliance rules | HwStorPortProhibitedDDIs(storport), SpNoWait(storport), StorPortStartIo(storport) |