FltAllocateFileLock-Funktion (fltkernel.h)

2024-12-21

Die FltAllocateFileLock- Routine weist eine neue FILE_LOCK Struktur zu und initialisiert sie.

Syntax

PFILE_LOCK FLTAPI FltAllocateFileLock(
  [in, optional] PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE CompleteLockCallbackDataRoutine,
  [in, optional] PUNLOCK_ROUTINE                          UnlockRoutine
);

Parameter

[in, optional] CompleteLockCallbackDataRoutine

Zeigen Sie auf eine PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE-typierte Rückrufroutine, die aufgerufen werden soll, wenn eine IRP_MJ_LOCK_CONTROL Anforderung abgeschlossen ist. Dieser Parameter ist optional und kann NULL sein.

[in, optional] UnlockRoutine

Zeiger auf eine PUNLOCK_ROUTINE-typierte Rückrufroutine, die aufgerufen werden soll, wenn der Bytebereich entsperrt wird. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

FltAllocateFileLock gibt einen Zeiger auf die neu zugeordnete FILE_LOCK Struktur zurück.

Bemerkungen

FltAllocateFileLock eine neue FILE_LOCK Struktur aus seitenseitigem Pool zuordnet und initialisiert sie.

Die zurückgegebene FILE_LOCK Struktur kann verwendet werden, um einen Bytebereich in einer Datei zu sperren, indem FltProcessFileLockaufgerufen wird.

Wenn die FILE_LOCK Struktur nicht mehr benötigt wird, kann sie durch Aufrufen FltUninitializeFileLocknicht initialisiert werden. Die nicht initialisierte FILE_LOCK-Struktur kann dann für die Wiederverwendung initialisiert werden, indem FltInitializeFileLockaufgerufen wird.

Rufen Sie FltFreeFileLockauf, um eine initialisierte FILE_LOCK Struktur frei zu geben.

Wenn der an FltProcessFileLock übergebene parameter CallbackData einen schnellen E/A-Vorgang darstellt, wird der in CompleteLockCallbackDataRoutine angegebene Rückruf nicht aufgerufen. Nur wenn der E/A-Vorgang in CallbackData- ein IRP ist und CompleteLockCallbackDataRou tine nicht NULL ist, wird die Rückrufroutine aufgerufen.

Anforderungen

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