FsRtlFastLock-Makro (ntifs.h)

Artikel
12/21/2024

Das FsRtlFastLock Makros wird von Dateisystemen und Filtertreibern verwendet, um eine Bytebereichssperre für einen Dateidatenstrom anzufordern.

Syntax

BOOLEAN
FsRtlFastLock( A1,   /* FileLock            */
               A2,   /* FileObject          */
               A3,   /* FileOffset          */
               A4,   /* Length              */
               A5,   /* ProcessId           */
               A6,   /* Key                 */
               A7,   /* FailImmediately     */
               A8,   /* ExclusiveLock       */
               A9,   /* Iosb                */
               A10,  /* Context             */
               A11   /* AlreadySynchronized */ )

Parameter

A1

[in] FileLock-: Zeiger auf die FILE_LOCK Struktur für die Datei. Diese Struktur muss durch einen vorherigen Aufruf von FsRtlAllocateFileLock oder FsRtlInitializeFileLockinitialisiert worden sein.

A2

[in] FileObject-: Zeiger auf die FILE_OBJECT für die geöffnete Datei. Das Dateiobjekt muss mit GENERIC_READ oder GENERIC_WRITE Zugriff auf die Datei (oder beides) erstellt worden sein.

A3

[in] FileOffset-: Zeiger auf eine Variable, die den Anfangsbyte-Offset innerhalb der Datei des zu sperrenden Bereichs angibt.

A4

[in] Length: Zeiger auf eine Variable, die die Länge in Byte des zu sperrenden Bereichs angibt.

A5

[in] ProcessId-: Zeiger auf die EPROCESS- Prozess-ID für den Prozess, der die Bytebereichssperre anfordert.

A6

[in] Key: Der Schlüssel, der der Bytebereichssperre zugewiesen werden soll.

A7

[in] FailImmediately: Boolescher Wert, der angibt, ob die Sperranforderung fehlschlagen soll, wenn die Sperre nicht sofort gewährt werden kann. Wenn der Aufrufer in einen Wartezustand versetzt werden kann, bis die Anforderung erteilt wird, legen Sie FailImmediately auf FALSE fest. Wenn dies nicht möglich ist, legen Sie FailImmediately auf TRUE fest.

A8

[in] ExclusiveLock-: Auf TRUE festgelegt, wenn eine exklusive Sperre angefordert wird, FALSE, wenn eine freigegebene Sperre angefordert wird.

A9

[out] Iosb-: Zeiger auf eine vom Anrufer zugewiesene IO_STATUS_BLOCK Struktur, die Statusinformationen zur Sperranforderung empfängt.

A10

[in] Kontext-: Optionaler Zeiger auf einen Kontext, der beim Freigeben der Bytebereichssperre verwendet werden soll.

A11

[in] AlreadySynchronized: Dieser Parameter ist veraltet, wird jedoch zur Kompatibilität mit älteren Treibern beibehalten.

Rückgabewert

Nichts

Bemerkungen

Das FsRtlFastLock Makro bewirkt, dass der Aufrufer eine Bytebereichssperre für einen Bereich der angegebenen Datei abruft.

FsRtlFastLock gibt WAHR zurück, um anzugeben, dass die IO_STATUS_BLOCK Struktur, auf die Iosb verweist, erhaltene Statusinformationen über den Sperrvorgang erhalten hat; andernfalls wird FALSE zurückgegeben.

Um den Inhalt der Struktur zu untersuchen, auf die Iosb verweist, verwenden Sie das NT_STATUS Makro.