FSCTL_OPLOCK_BREAK_ACKNOWLEDGE control code
The FSCTL_OPLOCK_BREAK_ACKNOWLEDGE control code responds to notification that an exclusive (level 1, batch, or filter) opportunistic lock (oplock) on a file has been broken.
A client application sends this control code to indicate that it acknowledges the oplock break and that, if the oplock is a level 1 oplock that was broken to level 2, it does want the level 2 oplock.
For more information about opportunistic locking and about the FSCTL_OPLOCK_BREAK_ACKNOWLEDGE control code, see the Microsoft Windows SDK documentation.
Opaque oplock object pointer for the file.
FltOplockFsctrl only. Callback data (FLT_CALLBACK_DATA) structure for an IRP_MJ_FILE_SYSTEM_CONTROL FSCTL request. The FsControlCode parameter for the operation must be FSCTL_OPLOCK_BREAK_ACKNOWLEDGE.
FsRtlOplockFsctrl only. IRP for an IRP_MJ_FILE_SYSTEM_CONTROL FSCTL request. The FsControlCode parameter for the operation must be FSCTL_OPLOCK_BREAK_ACKNOWLEDGE.
Not used with this operation; set to zero.
FltOplockFsctrl returns FLT_PREOP_PENDING for this operation when a level 1 oplock is broken to level 2, and the level 2 oplock has been granted. Otherwise, it returns FLT_PREOP_COMPLETE.
FsRtlOplockFsctrl returns one of the following NTSTATUS values for this operation:
The oplock break is acknowledged. No remaining oplocks are held.
No oplock was held by this handle, or the oplock break is not currently in progress. This is an error code.
The oplock break is acknowledged. On return, the sender of the FSCTL_OPLOCK_BREAK_ACKNOWLEDGE control code holds a level 2 oplock. This is a success code.
- FLT_PARAMETERS for IRP_MJ_FILE_SYSTEM_CONTROL