Makro FsRtlFastLock (ntifs.h)

Artikel
05/23/2024

Makro FsRtlFastLock digunakan oleh sistem file dan driver filter untuk meminta kunci rentang byte untuk aliran file.

Sintaks

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: Penunjuk ke struktur FILE_LOCK untuk file. Struktur ini harus diinisialisasi oleh panggilan sebelumnya ke FsRtlAllocateFileLock atau FsRtlInitializeFileLock.

A2

[in] FileObject: Penunjuk ke FILE_OBJECT untuk file yang terbuka. Objek file harus dibuat dengan akses GENERIC_READ atau GENERIC_WRITE ke file (atau keduanya).

A3

[in] FileOffset: Penunjuk ke variabel yang menentukan offset byte awal dalam file rentang yang akan dikunci.

A4

[in] Panjang: Penunjuk ke variabel yang menentukan panjang dalam byte rentang yang akan dikunci.

A5

[in] ProcessId: Penunjuk ke ID proses EPROCESS untuk proses yang meminta kunci rentang byte.

A6

[in] Kunci: Kunci yang akan ditetapkan ke kunci rentang byte.

A7

[in] FailImmediately: Nilai Boolean yang menentukan apakah permintaan kunci harus gagal jika kunci tidak dapat segera diberikan. Jika penelepon dapat dimasukkan ke dalam status tunggu hingga permintaan diberikan, atur FailImmediately ke FALSE. Jika tidak dapat, atur FailImmediately ke TRUE.

A8

[in] ExclusiveLock: Atur ke TRUE jika kunci eksklusif diminta, FALSE jika kunci bersama diminta.

A9

[keluar] Iosb: Penunjuk ke struktur IO_STATUS_BLOCK yang dialokasikan pemanggil yang menerima informasi status tentang permintaan kunci.

A10

[in] Konteks: Penunjuk opsional ke konteks yang akan digunakan saat merilis kunci rentang byte.

A11

[in] AlreadySynchronized: Parameter ini kedaluwarsa, tetapi dipertahankan untuk kompatibilitas dengan driver warisan.

Menampilkan nilai

Tidak ada

Keterangan

Makro FsRtlFastLock menyebabkan pemanggil memperoleh kunci rentang byte pada wilayah file yang ditentukan.

FsRtlFastLock mengembalikan TRUE untuk menunjukkan bahwa struktur IO_STATUS_BLOCK yang ditunjukkan oleh Iosb menerima informasi status tentang operasi penguncian; jika tidak, ia mengembalikan FALSE.

Untuk memeriksa konten struktur yang ditunjuk Iosb , gunakan makro NT_STATUS.