Freigeben über


FSCTL_REQUEST_OPLOCK_LEVEL_1-Steuerelementcode

Der FSCTL_REQUEST_OPLOCK_LEVEL_1-Steuerelementcode fordert eine opportunistische Sperre (Oplock) der Ebene 1 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_1-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_1 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_1 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_OPLOCK_LEVEL_1 Vorgang abgeschlossen wurde. Dies ist ein Fehlercode.
STATUS_OPLOCK_NOT_GRANTED Der Oplock konnte nicht gewährt werden. Dies ist ein Fehlercode.

Anforderungen

Anforderungstyp Anforderung
Header Ntifs.h (schließen Sie Ntifs.h oder Fltkernel.h ein)

Weitere Informationen

FLT_CALLBACK_DATA

FLT_PARAMETERS

FLT_PARAMETERS für IRP_MJ_FILE_SYSTEM_CONTROL

FltOplockFsctrl

FSCTL_OPBATCH_ACK_CLOSE_PENDING

FSCTL_OPLOCK_BREAK_ACK_NO_2

FSCTL_OPLOCK_BREAK_ACKNOWLEDGE

FSCTL_OPLOCK_BREAK_NOTIFY

FSCTL_REQUEST_BATCH_OPLOCK

FSCTL_REQUEST_FILTER_OPLOCK

FSCTL_REQUEST_OPLOCK_LEVEL_2

FsRtlOplockFsctrl

IRP_MJ_FILE_SYSTEM_CONTROL