PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE Rückruffunktion (fltkernel.h)
Ein Minifiltertreiber kann eine Routine vom Typ PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE als CompleteLockCallbackDataRoutine-Rückrufroutine des Minifiltertreibers 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
Zeiger auf die Rückrufdatenstruktur (FLT_CALLBACK_DATA) für den IRP_MJ_LOCK_CONTROL Vorgang, der abgeschlossen wird. Der Sperranforderungstyp 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 entsprechenden NTSTATUS-Wert zurück. Wenn ein NTSTATUS-Wert zurückgegeben wird, der kein Erfolgscode ist, wird die Dateisperre aus der Datei entfernt.
Hinweise
Ein Minifiltertreiber kann optional eine Routine vom Typ PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE als CompleteLockCallbackDataRoutine-Routine des Minifiltertreibers für eine Bytebereichsdateisperre angeben. Um diese Routine anzugeben, übergibt der Minifiltertreiber einen Zeiger auf 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 |
---|---|
Unterstützte Mindestversion (Client) | Windows XP SP2 |
Unterstützte Mindestversion (Server) | Windows Server 2003 SP1 |
Zielplattform | Desktop |
Kopfzeile | fltkernel.h (include Fltkernel.h) |
IRQL | <=APC_LEVEL |