FSCTL_REQUEST_BATCH_OPLOCK Steuerungscode

Artikel
02/02/2024

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.