PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE fonction de rappel (fltkernel.h)

Article
12/22/2024

Un pilote minifilter peut inscrire une routine de type PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE en tant que routine de rappel CompleteLockCallbackDataRou tine 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 des données de rappel (FLT_CALLBACK_DATA) pour l’opération de IRP_MJ_LOCK_CONTROL en cours d’exécution. Le type de demande de verrouillage est l’un des éléments suivants :

IRP_MN_LOCK
IRP_MN_UNLOCK_ALL
IRP_MN_UNLOCK_ALL_BY_KEY
IRP_MN_UNLOCK_SINGLE

Valeur de retour

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 en tant que CompleteLockCallbackDataRoutine routine du pilote minifilter pour un verrou de fichier d’octets. Pour spécifier cette routine, le pilote minifilter transmet un pointeur à la routine en tant que paramètre CompleteLockCallbackDataRoutine pour FltAllocateFileLock.

Lorsque vous effectuez une opération de IRP_MJ_LOCK_CONTROL pour le verrou de fichier, le gestionnaire de filtre appelle cette routine, le cas échéant, en tant que notification au minifilter.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP SP2
serveur minimum pris en charge	Windows Server 2003 SP1
plateforme cible	Bureau
d’en-tête	fltkernel.h (include Fltkernel.h)
IRQL	<=APC_LEVEL