Fonction FsRtlCheckLockForReadAccess (ntifs.h)

Article
02/26/2024

La routine FsRtlCheckLockForReadAccess détermine si le processus associé à un IRP donné a un accès en lecture à une région verrouillée d’un fichier.

Syntaxe

BOOLEAN FsRtlCheckLockForReadAccess(
  [in] PFILE_LOCK FileLock,
  [in] PIRP       Irp
);

Paramètres

[in] FileLock

Pointeur vers la structure FILE_LOCK pour le fichier. Cette structure doit avoir été initialisée par un appel précédent à FsRtlAllocateFileLock ou FsRtlInitializeFileLock.

[in] Irp

Pointeur vers l’IRP. Doit être un IRP pour une opération de lecture.

Valeur retournée

FsRtlCheckLockForReadAccess retourne TRUE si le processus dispose d’un accès en lecture, false dans le cas contraire.

Remarques

Sur Microsoft Windows XP et versions ultérieures, FsRtlCheckLockForReadAccess vérifie le processus auquel le thread qui a demandé l’opération de lecture est actuellement attaché.

Sur Microsoft Windows 2000 et versions antérieures, FsRtlCheckLockForReadAccess vérifie le processus qui a créé le thread.

FsRtlCheckLockForReadAccess vérifie s’il existe des verrous en conflit dans la plage d’octets à lire.

FsRtlCheckLockForReadAccess ne termine pas l’IRP spécifié par Irp.

Les minifiltres doivent appeler FltCheckLockForReadAccess au lieu de FsRtlCheckLockForReadAccess.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ntifs.h (include Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport)