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_PARAMETERS für IRP_MJ_FILE_SYSTEM_CONTROL
FSCTL_OPBATCH_ACK_CLOSE_PENDING