FsRtlInitializeFileLock-Funktion (ntifs.h)

Artikel
2024-12-21

Die FsRtlInitializeFileLock Routine initialisiert eine FILE_LOCK Struktur.

Syntax

void FsRtlInitializeFileLock(
  [in]           PFILE_LOCK                 FileLock,
  [in, optional] PCOMPLETE_LOCK_IRP_ROUTINE CompleteLockIrpRoutine,
  [in, optional] PUNLOCK_ROUTINE            UnlockRoutine
);

Parameter

[in] FileLock

Zeiger auf eine nicht initialisierte FILE_LOCK Struktur.

[in, optional] CompleteLockIrpRoutine

Zeigen Sie auf eine PCOMPLETE_LOCK_IRP_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

Nichts

Bemerkungen

FsRtlInitializeFileLock initialisiert eine nicht initialisierte FILE_LOCK Struktur.

Es ist ein Programmierfehler, FsRtlInitializeFileLock für eine FILE_LOCK Struktur aufzurufen, die bereits von FsRtlInitializeFileLock oder FltAllocateFileLockinitialisiert wurde, es sei denn, die Struktur wurde durch einen nachfolgenden Aufruf von FsRtlUninitializeFileLocknicht initialisiert.

Nach der Initialisierung kann die FILE_LOCK-Struktur verwendet werden, um einen Bytebereich in einer Datei zu sperren, indem FsRtlProcessFileLock oderFsRtlFastLockaufgerufen wird. FsRtlProcessFileLock Sperr-IRPs verarbeitet. FsRtlFastLock führt nicht-IRP-Sperren durch.

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

Minifilter müssen FltInitializeFileLock anstelle von FsRtlInitializeFileLockaufrufen.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= APC_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport)