FsRtlInitializeOplock function (ntifs.h)

Article
02/22/2024

FsRtlInitializeOplock initializes an opportunistic lock (oplock) pointer.

Syntax

void FsRtlInitializeOplock(
  [in, out] POPLOCK Oplock
);

Parameters

[in, out] Oplock

Caller-supplied pointer variable that receives the initialized opportunistic lock pointer. This variable must be initialized to NULL before the initial call to FsRtlInitializeOplock.

Return value

None

Remarks

File systems and filter drivers call FsRtlInitializeOplock to initialize an opaque opportunistic lock pointer.

When the opportunistic lock pointer is no longer needed, it can be uninitialized by calling FsRtlUninitializeOplock. The uninitialized opportunistic lock pointer can then be initialized for reuse by calling FsRtlInitializeOplock.

For detailed information about opportunistic locks, see the Microsoft Windows SDK documentation.

Minifilters should call FltInitializeOplock instead of FsRtlInitializeOplock.

Requirements

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