Fonction FsRtlOplockBreakToNoneEx (ntifs.h)
La routine FsRtlOplockBreakToNoneEx interrompt immédiatement tous les verrous opportunistes (oplocks) sans tenir compte des touches oplock.
Syntaxe
NTSTATUS FsRtlOplockBreakToNoneEx(
[in, out] POPLOCK Oplock,
[in] PIRP Irp,
[in] ULONG Flags,
[in, optional] PVOID Context,
[in, optional] POPLOCK_WAIT_COMPLETE_ROUTINE CompletionRoutine,
[in, optional] POPLOCK_FS_PREPOST_IRP PostIrpRoutine
);
Paramètres
[in, out] Oplock
Pointeur oplock opaque pour le fichier. Ce pointeur doit avoir été initialisé par un appel précédent à FsRtlInitializeOplock.
[in] Irp
Pointeur vers l’IRP pour l’opération d’E/S.
[in] Flags
Masque de bits pour l’opération d’E/S de fichier associée. Un système de fichiers ou un pilote de filtre définit des bits pour spécifier le comportement de FsRtlOplockBreakToNoneEx. Le paramètre Flags comporte les options suivantes :
OPLOCK_FLAG_COMPLETE_IF_OPLOCKED (0x00000001)
Spécifie pour permettre à un arrêt oplock de se poursuivre sans bloquer ou en attendant l’opération qui a provoqué l’arrêt de l’oplock. En règle générale, cet indicateur n’est utilisé que si l’IRP que pointe le paramètre Irp déclare une opération de IRP_MJ_CREATE.
[in, optional] Context
Pointeur vers les informations de contexte définies par l’appelant à passer aux routines de rappel auxquelles pointent les paramètres CompletionRoutine et PostIrpRoutine .
[in, optional] CompletionRoutine
Pointeur vers une routine de rappel fournie par l’appelant. Si un arrêt d’opération est en cours, cette routine est appelée lorsque l’arrêt est terminé. Ce paramètre est facultatif et peut être NULL. S’il est NULL, l’appelant est placé dans un état d’attente jusqu’à ce que l’arrêt d’opération soit terminé.
Cette routine est déclarée comme suit :
typedef VOID
(*POPLOCK_WAIT_COMPLETE_ROUTINE) (
IN PVOID Context,
IN PIRP Irp
);
Cette routine a les paramètres suivants :
Context
Pointeur d’informations de contexte qui a été passé dans le paramètre Context à FsRtlOplockBreakToNoneEx.
Irp
Pointeur vers l’IRP pour l’opération d’E/S.
[in, optional] PostIrpRoutine
Pointeur vers une routine de rappel fournie par l’appelant à appeler si l’opération d’E/S doit être suspendu. La routine est appelée avant que le package oplock n’arrête l’IRP. Ce paramètre est facultatif et peut être NULL.
Cette routine est déclarée comme suit :
typedef VOID
(*POPLOCK_FS_PREPOST_IRP) (
IN PVOID Context,
IN PIRP Irp
);
Context
Pointeur d’informations de contexte qui a été passé dans le paramètre Context à FsRtlOplockBreakToNoneEx.
Irp
Pointeur vers l’IRP pour l’opération d’E/S.
Valeur retournée
FsRtlOplockBreakToNoneEx retourne STATUS_SUCCESS ou un code NTSTATUS approprié, comme l’un des éléments suivants :
| Code de retour | Description |
|---|---|
|
L’IRP a été annulé. STATUS_CANCELLED est un code d’erreur. |
|
Une pause oplock est en cours. Par conséquent, l’IRP a été suspendu. STATUS_PENDING est un code de réussite. |
|
Un verrou opportuniste (oplock) est en cours. STATUS_OPLOCK_BREAK_IN_PROGRESS est un code de réussite que FsRtlOplockBreakToNoneEx retourne si l’appelant a défini OPLOCK_FLAG_COMPLETE_IF_OPLOCKED dans le paramètre Flags et qu’un oplock doit être rompu. |
Remarques
Pour plus d’informations sur les verrous opportunistes, consultez la documentation Microsoft Windows SDK.
Les minifiltres doivent appeler FltOplockBreakToNoneEx au lieu de FsRtlOplockBreakToNoneEx.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | La routine FsRtlOplockBreakToNoneEx est disponible à partir de Windows 7. |
| Plateforme cible | Universal |
| En-tête | ntifs.h (inclure Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |