Fungsi FsRtlAllocateFileLock (ntifs.h)

Artikel
02/26/2024

Rutinitas FsRtlAllocateFileLock mengalokasikan dan menginisialisasi struktur FILE_LOCK baru.

Sintaks

PFILE_LOCK FsRtlAllocateFileLock(
  [in, optional] PCOMPLETE_LOCK_IRP_ROUTINE CompleteLockIrpRoutine,
  [in, optional] PUNLOCK_ROUTINE            UnlockRoutine
);

Parameter

[in, optional] CompleteLockIrpRoutine

Penunjuk 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

Penunjuk 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

FsRtlAllocateFileLock mengembalikan pointer ke struktur FILE_LOCK yang baru dialokasikan.

Keterangan

FsRtlAllocateFileLock mengalokasikan struktur FILE_LOCK baru dari kumpulan halaman dan menginisialisasinya.

Minifilter harus memanggil FltAllocateFileLock alih-alih FsRtlAllocateFileLock.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), SpNoWait(storport), StorPortStartIo(storport)