Export (0) Print
Expand All
Expand Minimize

FsRtlFastUnlockSingle routine

The FsRtlFastUnlockSingle routine releases a byte-range lock that was acquired by the specified process, with the specified key value, file offset, and length, for a file.

Syntax


NTSTATUS FsRtlFastUnlockSingle(
  _In_      PFILE_LOCK FileLock,
  _In_      PFILE_OBJECT FileObject,
  _In_      LARGE_INTEGER UNALIGNED *FileOffset,
  _In_      PLARGE_INTEGER Length,
  _In_      PEPROCESS ProcessId,
  _In_      ULONG Key,
  _In_opt_  PVOID Context,
  _In_      BOOLEAN AlreadySynchronized
);

Parameters

FileLock [in]

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

FileObject [in]

A pointer to the file object for the file.

FileOffset [in]

A pointer to a variable that specifies the starting byte offset within the file of the range to be unlocked.

Length [in]

A pointer to a variable that specifies the length, in bytes, of the range to be unlocked.

ProcessId [in]

A pointer to the process ID for the process.

Key [in]

The key for the byte-range lock.

Context [in, optional]

An optional context pointer to be used when completing IRPs.

AlreadySynchronized [in]

This parameter is obsolete, but is retained for compatibility with legacy drivers.

Return value

The FsRtlFastUnlockSingle routine returns STATUS_SUCCESS or an error status code such as STATUS_RANGE_NOT_LOCKED.

Requirements

Version

Available in Microsoft Windows 2000 and later.

Header

Ntifs.h (include FltKernel.h or Ntifs.h)

Library

Ntoskrnl.lib

IRQL

<= APC_LEVEL

See also

FsRtlAllocateFileLock
FsRtlInitializeFileLock

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft