FSCTL_OPLOCK_BREAK_ACKNOWLEDGE Steuerungscode

Artikel
03/14/2023

Der FSCTL_OPLOCK_BREAK_ACKNOWLEDGE-Kontrollcode reagiert auf eine Benachrichtigung, dass eine exklusive (Ebene 1, Batch oder Filter) opportunistische Sperre (Oplock) für eine Datei unterbrochen wurde.

Eine Clientanwendung sendet diesen Steuerungscode, um anzugeben, dass sie den Oplock-Umbruch bestätigt und dass, wenn es sich bei oplock um einen Oplock der Ebene 1 handelt, der auf Ebene 2 unterbrochen wurde, der Oplock der Ebene 2 sein soll.

Um diesen Steuerelementcode zu verarbeiten, ruft ein Minifilter FltOplockFsctrl mit den folgenden Parametern auf. Ein Dateisystem oder Legacyfiltertreiber ruft FsRtlOplockFsctrl auf.

Weitere Informationen zum opportunistischen Sperren und zum FSCTL_OPLOCK_BREAK_ACKNOWLEDGE-Steuerungscode finden Sie in der Microsoft Windows SDK-Dokumentation.

Parameter

Oplock: Undurchsichtiger Oplock-Objektzeiger für die Datei.
CallbackData: Nur FltOplockFsctrl . Rückrufdatenstruktur (FLT_CALLBACK_DATA) für eine IRP_MJ_FILE_SYSTEM_CONTROL FSCTL-Anforderung. Der FsControlCode-Parameter für den Vorgang muss FSCTL_OPLOCK_BREAK_ACKNOWLEDGE sein.
Irp: Nur FsRtlOplockFsctrl . IRP für eine IRP_MJ_FILE_SYSTEM_CONTROL FSCTL-Anforderung. Der FsControlCode-Parameter für den Vorgang muss FSCTL_OPLOCK_BREAK_ACKNOWLEDGE sein.
OpenCount: Wird bei diesem Vorgang nicht verwendet; auf 0 festgelegt.

Statusblock

FltOplockFsctrl gibt FLT_PREOP_PENDING für diesen Vorgang zurück, wenn ein Oplock der Ebene 1 auf Ebene 2 unterbrochen und der Oplock der Stufe 2 gewährt wurde. Andernfalls wird FLT_PREOP_COMPLETE zurückgegeben.

FsRtlOplockFsctrl gibt einen der folgenden NTSTATUS-Werte für diesen Vorgang zurück:

Code	Bedeutung
STATUS_SUCCESS	Der Oplock-Umbruch wird bestätigt. Es werden keine verbleibenden Oplocks gehalten.
STATUS_INVALID_OPLOCK_PROTOCOL	Dieser Handle hat keinen Oplock gehalten, oder der Oplock-Umbruch wird derzeit nicht ausgeführt. Dies ist ein Fehlercode.
STATUS_PENDING	Der Oplock-Umbruch wird bestätigt. Bei der Rückgabe enthält der Absender des FSCTL_OPLOCK_BREAK_ACKNOWLEDGE-Steuerelementcodes einen Oplock der Ebene 2. Dies ist ein Erfolgscode.