PCOMPLETE_LOCK_IRP_ROUTINE función de devolución de llamada (ntifs.h)

Artículo
02/29/2024

Un controlador de filtro del sistema de archivos (filtro heredado) puede registrar una rutina con tipo PCOMPLETE_LOCK_IRP_ROUTINE como devolución de llamada CompleteLockIrpRoutine del filtro.

Sintaxis

PCOMPLETE_LOCK_IRP_ROUTINE PcompleteLockIrpRoutine;

NTSTATUS PcompleteLockIrpRoutine(
  PVOID Context,
  PIRP Irp
)
{...}

Parámetros

Context

[in] Puntero de contexto que se pasó a FsRtlProcessFileLock.

Irp

[in] IRP para el bloqueo de archivos IRP_MJ_LOCK_CONTROL solicitud que se está completando. El tipo de solicitud de bloqueo será uno de los siguientes:

IRP_MN_LOCK
IRP_MN_UNLOCK_ALL
IRP_MN_UNLOCK_ALL_BY_KEY
IRP_MN_UNLOCK_SINGLE

Valor devuelto

Esta rutina devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado. Si devuelve un valor NTSTATUS que no es un código correcto, el bloqueo de archivo se quita del archivo.

Comentarios

Un controlador de filtro del sistema de archivos (filtro heredado) puede especificar opcionalmente una rutina con tipo PCOMPLETE_LOCK_IRP_ROUTINE como rutina CompleteLockIrpRoutine del filtro heredado para un bloqueo de archivo de intervalo de bytes.

Para especificar esta rutina, un filtro heredado pasa un puntero a la rutina como el parámetro CompleteLockIrpRoutine para FsRtlAllocateFileLock o FsRtlInitializeFileLock.

Si el filtro heredado especifica una rutina CompleteLockIrpRoutine para un bloqueo de archivo, el sistema llama a esta rutina al completar una operación de IRP_MJ_LOCK_CONTROL para el bloqueo de archivo.