CcScheduleReadAhead, fonction (ntifs.h)

Article
03/01/2024

La routine CcScheduleReadAhead effectue une lecture anticipée (également appelée « lecture différée ») sur un fichier mis en cache. CcScheduleReadAhead ne doit jamais être appelé directement. La macro CcReadAhead doit être appelée à la place.

Syntaxe

void CcScheduleReadAhead(
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER FileOffset,
  [in] ULONG          Length
);

Paramètres

[in] FileObject

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

[in] FileOffset

Pointeur vers une variable qui spécifie le décalage d’octets de départ 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.

Valeur de retour

None

Remarques

La macro CcReadAhead est un wrapper pour CcScheduleReadAhead. Elle appelle CcScheduleReadAhead uniquement si Length>= 256. Des mesures ont montré que l’appel de CcScheduleReadAhead pour des lectures plus petites diminue en fait les performances.

CcReadAhead et CcScheduleReadAhead ne peuvent être appelés qu’après un appel réussi à CcCopyRead, CcFastCopyRead ou CcMdlRead.