Función MmPrefetchPages (ntifs.h)

La rutina MmPrefetchPages lee grupos de páginas del almacenamiento secundario de forma óptima.

Sintaxis

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

Parámetros

[in] NumberOfLists

Número de listas de lectura de la matriz pasadas en el parámetro ReadLists.

[in] ReadLists

Puntero a una matriz de listas de lectura que se van a capturar previamente.

Valor devuelto

MmPrefetchPages devuelve STATUS_SUCCESS o un estado de error adecuado que representa el estado de finalización final de la operación. Entre los códigos de estado de error posibles se incluyen los siguientes:

Código devuelto	Descripción
STATUS_INSUFFICIENT_RESOURCES	No se pudo asignar un búfer temporal requerido por esta función.
STATUS_INVALID_PARAMETER_1	Se proporcionó una sección de readLists (por ejemplo, una sección con respaldo físico o pagefile) o un valor NumberOfLists no válido.

MmPrefetchPages devuelve STATUS_SUCCESS correcto y también si todas las páginas solicitadas ya estaban en memoria, lo que indica que no se requerían lecturas del almacenamiento secundario.

Observaciones

MmPrefetchPages lee páginas del almacenamiento secundario descrito en las listas de lectura de la manera óptima. El autor de la llamada crea una lista de varios objetos de archivo y desplazamientos de bloques lógicos, pasándolos a la función mmPrefetchPages de que examina las páginas internas, leyendo en las que aún no son válidas o en transición. Las páginas se leen con una sola lectura, usando una página ficticia para salvar pequeños huecos. Si la brecha es "grande", se emiten lecturas independientes.

Nota

El objeto de sección debe existir para que el archivo esté previamente capturado. Se puede obtener un identificador de sección llamando a ZwCreateSection.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h, Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)