Funzione MmPrefetchPages (ntifs.h)

Articolo
02/29/2024

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)

Condividi tramite