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 abgeschlossenen IRP_MJ_LOCK_CONTROL Vorgang. 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 geeigneten 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 des vorgangs IRP_MJ_LOCK_CONTROL 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 (fltkernel.h einschließen) |
| IRQL | <=APC_LEVEL |