Fonction CcScheduleReadAheadEx (ntifs.h)

Article
02/26/2024

La routine CcScheduleReadAheadEx effectue une lecture anticipée (également appelée « lecture différée ») sur un fichier mis en cache. Le nombre d’octets d’E/S pour l’opération est facturé au thread d’émission.

Syntaxe

void CcScheduleReadAheadEx(
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER FileOffset,
  [in] ULONG          Length,
  [in] PETHREAD       IoIssuerThread
);

Paramètres

[in] FileObject

Pointeur vers un objet de fichier pour le fichier sur lequel une lecture anticipée doit être effectuée.

[in] FileOffset

Pointeur vers une variable qui spécifie le décalage d’octet de début dans le fichier mis en cache où la dernière lecture s’est produite.

[in] Length

Longueur en octets de la plage qui a été lue pour la dernière fois.

[in] IoIssuerThread

Thread qui émet la demande de lecture anticipée. Pour un système de fichiers avec la comptabilité des E/S de disque activée, il s’agit du thread sur lequel les E/S sont facturées. Si IoIssuerThread a la valeur NULL, les E/S sont facturées au thread actif.

Valeur de retour

None

Remarques

CcScheduleReadAheadEx doit être appelé uniquement lorsque Length>= 256. Les mesures ont montré que l’appel de CcScheduleReadAheadEx pour des lectures plus petites diminue en fait les performances.

CcScheduleReadAheadEx ne peut être appelé qu’après un appel réussi à CcCopyRead, CcCopyReadEx, CcFastCopyRead ou CcMdlRead.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h, FltKernel.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL