Funzione MmPrefetchPages (ntifs.h)

  • Articolo

La routine MmPrefetchPages legge gruppi di pagine dalla risorsa di archiviazione secondaria in modo ottimale.

Sintassi

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

Parametri

[in] NumberOfLists

Numero di elenchi di lettura nella matrice passati nel parametro ReadLists .

[in] ReadLists

Puntatore a una matrice di elenchi di lettura da prelettura.

Valore restituito

MmPrefetchPages restituisce STATUS_SUCCESS o uno stato di errore appropriato che rappresenta lo stato di completamento finale dell'operazione. I codici di stato di errore possibili includono quanto segue:

Codice restituito Descrizione
STATUS_INSUFFICIENT_RESOURCES Impossibile allocare un buffer temporaneo richiesto da questa funzione.
STATUS_INVALID_PARAMETER_1 Una sezione in ReadLists non è prefetchable (ad esempio, una sezione fisica o supportata dal file di paging) o è stato fornito un valore NumberOfLists non valido.

MmPrefetchPages restituisce STATUS_SUCCESS in caso di esito positivo e anche se tutte le pagine richieste erano già in memoria che indicavano che non erano necessarie letture dalla risorsa di archiviazione secondaria.

Commenti

MmPrefetchPages legge le pagine dall'archiviazione secondaria descritte nelle liste di lettura in modo ottimale. Il chiamante compila un elenco di vari oggetti file e offset di blocchi logici, passandoli alla funzione MmPrefetchPages che esamina le pagine interne, leggendo in quelle che non sono già valide o in transizione. Le pagine vengono lette con una sola lettura, usando una pagina fittizia per colmare piccole lacune. Se il gap è "grande", vengono rilasciate letture separate.

Nota

L'oggetto sezione deve esistere già per il prelettura del file. È possibile ottenere un handle di sezione chiamando ZwCreateSection.

Requisiti

Requisito Valore
Client minimo supportato Windows XP
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h, Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regole di conformità DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)