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

Artículo
12/21/2024

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

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.

Observaciones

Un controlador de filtro del sistema de archivos (filtro heredado) puede especificar opcionalmente una rutina de tipo PCOMPLETE_LOCK_IRP_ROUTINE como la rutina de 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 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 archivos.