FsRtlProcessFileLock routine

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

Syntax


NTSTATUS FsRtlProcessFileLock(
  _In_     PFILE_LOCK FileLock,
  _In_     PIRP       Irp,
  _In_opt_ PVOID      Context
);

Parameters

FileLock [in]

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

Irp [in]

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

Context [in, optional]

Optional context pointer to be used when completing IRPs.

Return value

FsRtlProcessFileLock returns STATUS_SUCCESS or an error status code. Error status codes include the following:

STATUS_INSUFFICIENT_RESOURCES
STATUS_INVALID_DEVICE_REQUEST
STATUS_RANGE_NOT_LOCKED

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

Target platform

Universal

Header

Ntifs.h (include Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

<= APC_LEVEL

See also

FltProcessFileLock
FsRtlAllocateFileLock
FsRtlInitializeFileLock
IRP_MJ_LOCK_CONTROL

 

 

Send comments about this topic to Microsoft

Show: