CcScheduleReadAheadEx, fonction (ntifs.h)
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 émettrice.
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 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é la dernière lecture.
[in] IoIssuerThread
Thread qui émet la demande en lecture anticipée. Pour un système de fichiers avec comptabilité d’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 actuel.
Valeur de retour
Aucun
Remarques
CcScheduleReadAheadEx doit être appelée uniquement lorsque Length>= 256. Les mesures ont montré que l’appel de CcScheduleReadAheadEx pour les lectures plus petites diminue réellement les performances.
CcScheduleReadAheadEx ne peut être appelé qu’après un appel réussi à CcCopyRead, CcCopyReadEx, CcFastCopyReadou CcMdlRead.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h, FltKernel.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |