FsRtlOplockIsFastIoPossible, fonction (ntifs.h)

Article
02/29/2024

FsRtlOplockIsFastIoPossible vérifie l’état de verrouillage opportuniste (oplock) d’un fichier pour déterminer si des E/S rapides peuvent être effectuées sur le fichier.

Syntaxe

BOOLEAN FsRtlOplockIsFastIoPossible(
  [in] POPLOCK Oplock
);

Paramètres

[in] Oplock

Pointeur de verrou opportuniste opaque pour le fichier. Ce pointeur doit avoir été initialisé par un appel précédent à FsRtlInitializeOplock.

Valeur retournée

FsRtlOplockIsFastIoPossible retourne FALSE s’il existe des verrous opportunistes en suspens sur le fichier qui empêchent l’exécution d’E/S rapides ; TRUE dans le cas contraire.

Remarques

FsRtlOplockIsFastIoPossible détermine si des E/S rapides peuvent être effectuées sur un fichier, selon les conditions suivantes :

Si le paramètre Oplock a la valeur NULL ou si la valeur de *Oplock est NULL, il n’existe aucun verrou opportuniste en suspens sur le fichier et des E/S rapides peuvent être effectuées sur le fichier.
Si un verrou opportuniste exclusif a été accordé pour le fichier, mais qu’aucun blocage d’opération n’est en cours, des E/S rapides peuvent être effectuées sur le fichier.

Pour plus d’informations sur les verrous opportunistes, consultez la documentation du Kit de développement logiciel (SDK) Windows.

Les minifiltres doivent appeler FltOplockIsFastIoPossible au lieu de FsRtlOplockIsFastIoPossible.