FsRtlProcessFileLock function (ntifs.h)

Article
02/22/2024

The FsRtlProcessFileLock routine processes and completes an IRP for a file lock operation.

Syntax

NTSTATUS FsRtlProcessFileLock(
  [in]           PFILE_LOCK FileLock,
  [in]           PIRP       Irp,
  [in, optional] PVOID      Context
);

Parameters

[in] FileLock

Pointer to the FILE_LOCK structure for the file. This structure must have been initialized by a previous call to FsRtlAllocateFileLock or FsRtlInitializeFileLock.

[in] Irp

Pointer to the IRP. Must be an IRP for a file-lock operation.

[in, optional] Context

Optional context pointer to be used when completing IRPs.

Return value

FsRtlProcessFileLock returns STATUS_SUCCESS on success; otherwise it returns an appropriate error status code.

Remarks

FsRtlProcessFileLock performs the specified lock operation on behalf of the process associated with thread that originally requested the operation.

On Microsoft Windows XP and later, this is the process to which the thread is currently attached.

On Microsoft Windows 2000 and earlier, it is the process that created the thread.

Callers of FsRtlProcessFileLock relinquish control of the input IRP.

Minifilters must call FltProcessFileLock instead of FsRtlProcessFileLock.

Requirements

Requirement	Value
Target Platform	Universal
Header	ntifs.h (include Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
DDI compliance rules	HwStorPortProhibitedDDIs(storport)