Partager via


PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE fonction de rappel (fltkernel.h)

Un pilote minifilter peut inscrire une routine de type PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE en tant que routine de rappel CompleteLockCallbackDataRoutine du pilote minifilter pour une structure FILE_LOCK .

Syntaxe

PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE PfltCompleteLockCallbackDataRoutine;

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

Paramètres

[in, optional] Context

Pointeur de contexte passé à FltProcessFileLock.

[in] CallbackData

Pointeur vers la structure de données de rappel (FLT_CALLBACK_DATA) pour l’opération IRP_MJ_LOCK_CONTROL en cours d’exécution. Le type de demande de verrouillage est l’un des suivants :

  • IRP_MN_LOCK
  • IRP_MN_UNLOCK_ALL
  • IRP_MN_UNLOCK_ALL_BY_KEY
  • IRP_MN_UNLOCK_SINGLE

Valeur retournée

Cette routine retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée. Si elle retourne une valeur NTSTATUS qui n’est pas un code de réussite, le verrou de fichier est supprimé du fichier.

Remarques

Un pilote minifilter peut éventuellement spécifier une routine de type PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE comme routine CompleteLockCallbackDataRoutine du pilote minifilter pour un verrou de fichier de plage d’octets. Pour spécifier cette routine, le pilote minifilter passe un pointeur vers la routine en tant que paramètre CompleteLockCallbackDataRoutine pour FltAllocateFileLock.

Lorsque vous terminez une opération de IRP_MJ_LOCK_CONTROL pour le verrou de fichier, le gestionnaire de filtres appelle cette routine, si elle est spécifiée, en tant que notification au minifiltre.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP SP2
Serveur minimal pris en charge Windows Server 2003 SP1
Plateforme cible Desktop (Expérience utilisateur)
En-tête fltkernel.h (inclure Fltkernel.h)
IRQL <=APC_LEVEL

Voir aussi

FILE_LOCK

FltAllocateFileLock

FltCheckLockForReadAccess

FltCheckLockForWriteAccess

FltFreeFileLock

FltInitializeFileLock

FltProcessFileLock

FltUninitializeFileLock

IRP_MJ_LOCK_CONTROL

PUNLOCK_ROUTINE