Funzione FsRtlAllocateFileLock (ntifs.h)

Articolo
12/20/2024

La routine FsRtlAllocateFileLock alloca e inizializza una nuova struttura FILE_LOCK.

Sintassi

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

Parametri

[in, optional] CompleteLockIrpRoutine

Puntatore a una routine di callback PCOMPLETE_LOCK_IRP_ROUTINEtipizzata da chiamare quando viene completata una richiesta di IRP_MJ_LOCK_CONTROL. Questo parametro è facoltativo e può essere NULL.

[in, optional] UnlockRoutine

Puntatore a una routine di callback PUNLOCK_ROUTINEtipizzata da chiamare quando l'intervallo di byte viene sbloccato. Questo parametro è facoltativo e può essere NULL.

Valore restituito

FsRtlAllocateFileLock restituisce un puntatore alla struttura FILE_LOCK appena allocata.

Osservazioni

FsRtlAllocateFileLock alloca una nuova struttura FILE_LOCK dal pool di paging e la inizializza.

I minifiltri devono chiamare FltAllocateFileLock anziché FsRtlAllocateFileLock.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000
piattaforma di destinazione	Universale
intestazione	ntifs.h (include Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	<= APC_LEVEL
regole di conformità DDI	HwStorPortProhibitedDDDIs(storport), SpNoWait(storport), StorPortStartIo(storport)