FsRtlOplockKeysEqual function (ntifs.h)

The FsRtlOplockKeysEqual routine compares the opportunistic lock (oplock) keys that are stored in the file object extensions of two file objects.

Syntax

BOOLEAN FsRtlOplockKeysEqual(
  [in, optional] PFILE_OBJECT Fo1,
  [in, optional] PFILE_OBJECT Fo2
);

Parameters

[in, optional] Fo1

A pointer to the first file object for the comparison.

[in, optional] Fo2

A pointer to the second file object for the comparison.

Return value

The FsRtlOplockKeysEqual routine returns TRUE if the keys match or if the file object pointers are the same. FsRtlOplockKeysEqual returns FALSE if the keys do not match, if either of the file objects is missing, or if either of the file objects does not have a key.

Remarks

If no oplock keys were provided when the file objects were created, they are considered to match if the file object pointers are the same (that is, they are the same file object). If the file object pointers are different and either or both of them do not have an associated oplock key, they are considered to not match.

Minifilters should call FltOplockKeysEqual instead of FsRtlOplockKeysEqual.

Requirements

Requirement Value
Minimum supported client The FsRtlOplockKeysEqual routine is available starting with Windows 7.
Target Platform Universal
Header ntifs.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

See also

FltOplockKeysEqual