FsRtlInitializeOplock function (ntifs.h)

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

See also

FSCTL_OPBATCH_ACK_CLOSE_PENDING

FSCTL_OPLOCK_BREAK_ACKNOWLEDGE

FSCTL_OPLOCK_BREAK_ACK_NO_2

FSCTL_OPLOCK_BREAK_NOTIFY

FSCTL_REQUEST_BATCH_OPLOCK

FSCTL_REQUEST_FILTER_OPLOCK

FSCTL_REQUEST_OPLOCK_LEVEL_1

FSCTL_REQUEST_OPLOCK_LEVEL_2

FltInitializeOplock

FsRtlCheckOplock

FsRtlCurrentBatchOplock

FsRtlOplockFsctrl

FsRtlOplockIsFastIoPossible

FsRtlUninitializeOplock