PCOMPLETE_LOCK_IRP_ROUTINE fonction de rappel (ntifs.h)
Un pilote de filtre de système de fichiers (filtre hérité) peut inscrire une routine PCOMPLETE_LOCK_IRP_ROUTINE-typée en tant que 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 é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 de filtre de système de fichiers (filtre hérité) peut éventuellement spécifier une routine PCOMPLETE_LOCK_IRP_ROUTINE typée comme routine de CompleteLockIrpRoutine routine pour un verrou de fichier de plage d’octets.
Pour spécifier cette routine, un filtre hérité transmet un pointeur à 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.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ntifs.h |
| IRQL | APC_LEVEL |