PCOMPLETE_LOCK_IRP_ROUTINE fonction de rappel (ntifs.h)

Article
02/29/2024

Un pilote de filtre de système de fichiers (filtre hérité) peut inscrire une routine de type PCOMPLETE_LOCK_IRP_ROUTINE comme rappel CompleteLockIrpRoutine du filtre.

Syntaxe

PCOMPLETE_LOCK_IRP_ROUTINE PcompleteLockIrpRoutine;

NTSTATUS PcompleteLockIrpRoutine(
  PVOID Context,
  PIRP Irp
)
{...}

Paramètres

Context

[in] Pointeur de contexte passé à FsRtlProcessFileLock.

Irp

[in] IRP pour le verrou de fichier IRP_MJ_LOCK_CONTROL demande 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. S’il retourne une valeur NTSTATUS qui n’est pas un code de réussite, le verrou de fichier est supprimé du fichier.

Remarques

Un pilote de filtre de système de fichiers (filtre hérité) peut éventuellement spécifier une routine de type PCOMPLETE_LOCK_IRP_ROUTINE comme routine CompleteLockIrpRoutine du filtre hérité pour un verrou de fichiers de plage d’octets.

Pour spécifier cette routine, un filtre hérité transmet un pointeur vers la routine en tant que paramètre CompleteLockIrpRoutine pour FsRtlAllocateFileLock ou FsRtlInitializeFileLock.

Si le filtre hérité spécifie une routine CompleteLockIrpRoutine pour un verrou de fichier, le système appelle cette routine lors de l’exécution d’une opération de IRP_MJ_LOCK_CONTROL pour le verrou de fichier.