FsRtlProcessFileLock function (ntifs.h)

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)

See also

FltProcessFileLock

FsRtlAllocateFileLock

FsRtlInitializeFileLock

IRP_MJ_LOCK_CONTROL