Funzione FsRtlInitializeFileLock (ntifs.h)
La routine FsRtlInitializeFileLock inizializza una struttura FILE_LOCK.
Sintassi
void FsRtlInitializeFileLock(
[in] PFILE_LOCK FileLock,
[in, optional] PCOMPLETE_LOCK_IRP_ROUTINE CompleteLockIrpRoutine,
[in, optional] PUNLOCK_ROUTINE UnlockRoutine
);
Parametri
[in] FileLock
Puntatore a una struttura di FILE_LOCK non inizializzata.
[in, optional] CompleteLockIrpRoutine
Puntatore a una routine di callback tipizzata PCOMPLETE_LOCK_IRP_ROUTINE 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_ROUTINE tipizzata da chiamare quando viene sbloccato l'intervallo di byte. Questo parametro è facoltativo e può essere NULL.
Valore restituito
nessuno
Osservazioni
FsRtlInitializeFileLock inizializza una struttura di FILE_LOCK non inizializzata.
Si tratta di un errore di programmazione per chiamare FsRtlInitializeFileLock per una struttura FILE_LOCK già inizializzata da FsRtlInitializeFileLock o FltAllocateFileLock, a meno che la struttura non sia stata inizializzata da una chiamata successiva a FsRtlUninitializeFileLock.
Una volta inizializzata, la struttura FILE_LOCK può essere usata per bloccare un intervallo di byte in un file chiamando FsRtlProcessFileLock oFsRtlFastLock. FsRtlProcessFileLock elabora i criteri di integrazione di blocco. FsRtlFastLock esegue il blocco non IRP.
Quando la struttura FILE_LOCK non è più necessaria, può essere non inizializzata chiamando FsRtlUninitializeFileLock. La struttura di FILE_LOCK non inizializzata può quindi essere inizializzata per il riutilizzo chiamando FsRtlInitializeFileLock.
I minifilter devono chiamare FltInitializeFileLock anziché FsRtlInitializeFileLock.
Requisiti
Requisito | Valore |
---|---|
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) |