Fungsi FsRtlInitializeFileLock (ntifs.h)

Artikel
02/29/2024

Rutinitas FsRtlInitializeFileLock menginisialisasi struktur FILE_LOCK.

Sintaks

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

Parameter

[in] FileLock

Arahkan ke struktur FILE_LOCK yang tidak diinisialisasi.

[in, optional] CompleteLockIrpRoutine

Arahkan ke rutinitas panggilan balik yang ditik PCOMPLETE_LOCK_IRP_ROUTINE untuk dipanggil saat permintaan IRP_MJ_LOCK_CONTROL selesai. Parameter ini bersifat opsional dan dapat berupa NULL.

[in, optional] UnlockRoutine

Arahkan ke rutinitas panggilan balik yang ditik PUNLOCK_ROUTINE untuk dipanggil saat rentang byte tidak terkunci. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

Tidak ada

Keterangan

FsRtlInitializeFileLock menginisialisasi struktur FILE_LOCK yang tidak diinisialisasi.

Ini adalah kesalahan pemrograman untuk memanggil FsRtlInitializeFileLock untuk struktur FILE_LOCK yang telah diinisialisasi oleh FsRtlInitializeFileLock atau FltAllocateFileLock, kecuali struktur telah tidak diinisialisasi oleh panggilan berikutnya ke FsRtlUninitializeFileLock.

Setelah diinisialisasi, struktur FILE_LOCK dapat digunakan untuk mengunci rentang byte dalam file dengan memanggil FsRtlProcessFileLock atauFsRtlFastLock. FsRtlProcessFileLock memproses runtime integrasi kunci. FsRtlFastLock melakukan penguncian non-IRP.

Ketika struktur FILE_LOCK tidak lagi diperlukan, struktur tersebut dapat tidak diinisialisasi dengan memanggil FsRtlUninitializeFileLock. Struktur FILE_LOCK yang tidak diinisialisasi kemudian dapat diinisialisasi untuk digunakan kembali dengan memanggil FsRtlInitializeFileLock.

Minifilter harus memanggil FltInitializeFileLock alih-alih FsRtlInitializeFileLock.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport)