FSCTL_REQUEST_OPLOCK_LEVEL_2-Steuerelementcode

Artikel
03/14/2023

Der FSCTL_REQUEST_OPLOCK_LEVEL_2-Steuerelementcode fordert eine opportunistische Sperre (Oplock) der Ebene 2 für eine Datei an.

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

Weitere Informationen zu opportunistischen Sperren und zum FSCTL_REQUEST_OPLOCK_LEVEL_2-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_REQUEST_OPLOCK_LEVEL_2 sein.
Irp: Nur FsRtlOplockFsctrl . IRP für eine IRP_MJ_FILE_SYSTEM_CONTROL FSCTL-Anforderung. Der FsControlCode-Parameter für den Vorgang muss FSCTL_REQUEST_OPLOCK_LEVEL_2 sein.
OpenCount: Gibt den Sperrstatus der Datei an. Legen Sie diesen Parameter auf einen ULONG-Wert ungleich Null fest, wenn für die Datei Bytebereichssperren vorhanden sind, andernfalls null.

Statusblock

FltOplockFsctrl gibt FLT_PREOP_PENDING für diesen Vorgang zurück, wenn der Oplock 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_PENDING	Der Oplock wurde gewährt. Dies ist ein Erfolgscode.
STATUS_CANCELLED	Der IRP wurde abgebrochen, bevor der FSCTL_REQUEST_OPLOCK_LEVEL_2 Vorgang abgeschlossen wurde. Dies ist ein Fehlercode.
STATUS_OPLOCK_NOT_GRANTED	Der Oplock konnte nicht gewährt werden. Dies ist ein Fehlercode.