PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE función de devolución de llamada (fltkernel.h)

Un controlador de minifiltro puede registrar una rutina de tipo PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE como la rutina de devolución de llamada CompleteLockCallbackDataRoutine del controlador de minifiltro para una estructura de FILE_LOCK .

Sintaxis

PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE PfltCompleteLockCallbackDataRoutine;

NTSTATUS PfltCompleteLockCallbackDataRoutine(
  [in, optional] PVOID Context,
  [in]           PFLT_CALLBACK_DATA CallbackData
)
{...}

Parámetros

[in, optional] Context

Puntero de contexto que se pasó a FltProcessFileLock.

[in] CallbackData

Puntero a la estructura de datos de devolución de llamada (FLT_CALLBACK_DATA) para la operación de IRP_MJ_LOCK_CONTROL 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 minifiltro puede especificar opcionalmente una rutina de tipo PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE como la rutina CompleteLockCallbackDataRoutine del controlador de minifiltro para un bloqueo de archivo de intervalo de bytes. Para especificar esta rutina, el controlador de minifiltro pasa un puntero a la rutina como el parámetro CompleteLockCallbackDataRoutine para FltAllocateFileLock.

Al completar una operación de IRP_MJ_LOCK_CONTROL para el bloqueo de archivos, el administrador de filtros llama a esta rutina, si se especifica, como una notificación al minifiltro.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP SP2
Servidor mínimo compatible Windows Server 2003 SP1
Plataforma de destino Escritorio
Encabezado fltkernel.h (incluya Fltkernel.h)
IRQL <=APC_LEVEL

Consulte también

FILE_LOCK

FltAllocateFileLock

FltCheckLockForReadAccess

FltCheckLockForWriteAccess

FltFreeFileLock

FltInitializeFileLock

FltProcessFileLock

FltUninitializeFileLock

IRP_MJ_LOCK_CONTROL

PUNLOCK_ROUTINE