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

Artículo
05/23/2024

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