PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE Rückruffunktion (fltkernel.h)

Artikel
2024-12-21

Ein Minifiltertreiber kann eine Routine vom Typ PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE als die CompleteLockCallbackDataRoutine des Minifiltertreibers Rückrufroutine für eine FILE_LOCK Struktur registrieren.

Syntax

PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE PfltCompleteLockCallbackDataRoutine;

NTSTATUS PfltCompleteLockCallbackDataRoutine(
  [in, optional] PVOID Context,
  [in]           PFLT_CALLBACK_DATA CallbackData
)
{...}

Parameter

[in, optional] Context

Kontextzeiger, der an FltProcessFileLockübergeben wurde.

[in] CallbackData

Zeigen Sie auf die Rückrufdatenstruktur (FLT_CALLBACK_DATA) für den abgeschlossenen IRP_MJ_LOCK_CONTROL Vorgang. Der Typ der Sperranforderung ist einer der folgenden:

IRP_MN_LOCK
IRP_MN_UNLOCK_ALL
IRP_MN_UNLOCK_ALL_BY_KEY
IRP_MN_UNLOCK_SINGLE

Rückgabewert

Diese Routine gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück. Wenn ein NTSTATUS-Wert zurückgegeben wird, der kein Erfolgscode ist, wird die Dateisperre aus der Datei entfernt.

Bemerkungen

Ein Minifiltertreiber kann optional eine Routine vom Typ PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE als die CompleteLockCallbackDataRoutine Routine des Minifiltertreibers für eine Bytebereich-Dateisperre angeben. Um diese Routine anzugeben, übergibt der Minifiltertreiber einen Zeiger an die Routine als CompleteLockCallbackDataRoutine Parameter für FltAllocateFileLock.

Beim Abschließen eines IRP_MJ_LOCK_CONTROL Vorgangs für die Dateisperre ruft der Filter-Manager diese Routine auf, sofern angegeben, als Benachrichtigung an den Minifilter.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP SP2
mindestens unterstützte Server-	Windows Server 2003 SP1
Zielplattform-	Desktop
Header-	fltkernel.h (include Fltkernel.h)
IRQL-	<=APC_LEVEL