PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE Rückruffunktion (fltkernel.h)
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 |