MmPrefetchPages, fonction (ntifs.h)

Article
02/07/2025

Le MmPrefetchPages routine lit les groupes de pages du stockage secondaire de manière optimale.

Syntaxe

NTSTATUS MmPrefetchPages(
  [in] ULONG      NumberOfLists,
  [in] PREAD_LIST *ReadLists
);

Paramètres

[in] NumberOfLists

Nombre de listes de lecture dans le tableau transmis dans le paramètre ReadLists .

[in] ReadLists

Pointeur vers un tableau de listes de lecture à prérécupérer.

Valeur de retour

MmPrefetchPages retourne STATUS_SUCCESS ou un état d’erreur approprié représentant l’état d’achèvement final de l’opération. Les codes d’état d’erreur possibles sont les suivants :

Retourner le code	Description
STATUS_INSUFFICIENT_RESOURCES	Impossible d’allouer une mémoire tampon temporaire requise par cette fonction.
STATUS_INVALID_PARAMETER_1	Une section de ReadLists n’est pas prérécupérée (par exemple, une section physique ou de fichier de page) ou une valeur NumberOfLists non valide a été fournie.

MmPrefetchPages retourne STATUS_SUCCESS en cas de réussite et si toutes les pages demandées étaient déjà en mémoire indiquant qu’aucune lecture du stockage secondaire n’a été requise.

Remarques

MmPrefetchPages lit les pages du stockage secondaire décrits dans les listes de lecture de manière optimale. L’appelant génère une liste de différents objets de fichier et décalages de blocs logiques, en les transmettant à la fonction MmPrefetchPages qui examine les pages internes, en les lisant dans celles qui ne sont pas déjà valides ou en transition. Les pages sont lues avec une seule lecture, en utilisant une page factice pour combler les petites lacunes. Si l’écart est « grand », les lectures distinctes sont émises.

Note

L’objet de section doit déjà exister pour que le fichier soit prérécupéré. Un handle de section peut être obtenu en appelant ZwCreateSection.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h, Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
règles de conformité DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Partager via