FSCTL_REQUEST_FILTER_OPLOCK-Steuerelementcode

2024-02-02

Der FSCTL_REQUEST_FILTER_OPLOCK Kontrollcode fordert eine opportunistische Filtersperre (Oplock) 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_FILTER_OPLOCK-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_FILTER_OPLOCK 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_FILTER_OPLOCK sein.
OpenCount: Anzahl der Benutzerhandles für die Datei.

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_BATCH_OPLOCK Vorgang abgeschlossen wurde. Dies ist ein Fehlercode.
STATUS_OPLOCK_NOT_GRANTED	Der Oplock konnte nicht gewährt werden. Dies ist ein Fehlercode.