FSCTL_REQUEST_BATCH_OPLOCK Steuerungscode
Der FSCTL_REQUEST_BATCH_OPLOCK-Steuerelementcode fordert eine opportunistische Batchsperre (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 zum opportunistischen Sperren und zum FSCTL_REQUEST_BATCH_OPLOCK-Steuerelementcode 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_BATCH_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_BATCH_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 | Die 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. |
Anforderungen
| Anforderungstyp | Anforderung |
|---|---|
| Header | Ntifs.h (einschließlich Ntifs.h oder Fltkernel.h) |
Weitere Informationen
FLT_PARAMETERS für IRP_MJ_FILE_SYSTEM_CONTROL
FSCTL_OPBATCH_ACK_CLOSE_PENDING