Función FsRtlInitializeFileLock (ntifs.h)

Artículo
02/26/2024

La rutina FsRtlInitializeFileLock inicializa una estructura de FILE_LOCK.

Sintaxis

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

Parámetros

[in] FileLock

Puntero a una estructura de FILE_LOCK sin inicializar.

[in, optional] CompleteLockIrpRoutine

Puntero a una rutina de devolución de llamada con tipo PCOMPLETE_LOCK_IRP_ROUTINE que se llamará cuando se complete una solicitud de IRP_MJ_LOCK_CONTROL . Este parámetro es opcional y puede ser NULL.

[in, optional] UnlockRoutine

Puntero a una rutina de devolución de llamada con tipo PUNLOCK_ROUTINE que se va a llamar cuando se desbloquea el intervalo de bytes. Este parámetro es opcional y puede ser NULL.

Valor devuelto

None

Observaciones

FsRtlInitializeFileLock inicializa una estructura de FILE_LOCK sin inicializar.

Es un error de programación llamar a FsRtlInitializeFileLock para una estructura de FILE_LOCK que FsRtlInitializeFileLock o FltAllocateFileLock ya ha inicializado mediante una llamada posterior a FsRtlUninitializeFileLock.

Una vez inicializado, la estructura de FILE_LOCK se puede usar para bloquear un intervalo de bytes en un archivo llamando a FsRtlProcessFileLock oFsRtlFastLock. FsRtlProcessFileLock procesa IRP de bloqueo. FsRtlFastLock realiza bloqueos que no son IRP.

Cuando la estructura de FILE_LOCK ya no es necesaria, se puede anular la inicialización llamando a FsRtlUninitializeFileLock. La estructura de FILE_LOCK sin inicializar se puede inicializar para su reutilización llamando a FsRtlInitializeFileLock.

Los minifiltros deben llamar a FltInitializeFileLock en lugar de FsRtlInitializeFileLock.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	ntifs.h (incluya Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDDIs(storport)