Função MmPrefetchPages (ntifs.h)

A rotina MmPrefetchPages lê grupos de páginas do armazenamento secundário da maneira ideal.

Sintaxe

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

Parâmetros

[in] NumberOfLists

O número de listas de leitura na matriz passadas no parâmetro ReadLists .

[in] ReadLists

Um ponteiro para uma matriz de listas de leitura a serem pré-buscadas.

Retornar valor

MmPrefetchPages retorna STATUS_SUCCESS ou um erro apropriado status representando o status de conclusão final da operação. Os possíveis códigos de status de erro incluem o seguinte:

Código de retorno	Descrição
STATUS_INSUFFICIENT_RESOURCES	Não foi possível alocar um buffer temporário exigido por essa função.
STATUS_INVALID_PARAMETER_1	Uma seção em ReadLists não é pré-buscada (por exemplo, uma seção física ou com suporte de pagefile) ou um valor NumberOfLists inválido foi fornecido.

MmPrefetchPages retorna STATUS_SUCCESS com êxito e também se todas as páginas solicitadas já estavam na memória indicando que nenhuma leitura do armazenamento secundário era necessária.

Comentários

MmPrefetchPages lê páginas do armazenamento secundário descrito nas listas de leitura da maneira ideal. O chamador cria uma lista de vários objetos de arquivo e deslocamentos de bloco lógicos, passando-os para a função MmPrefetchPages que examina as páginas internas, lendo aquelas que ainda não são válidas ou em transição. As páginas são lidas com uma única leitura, usando uma página fictícia para preencher pequenas lacunas. Se a lacuna for "grande", as leituras separadas serão emitidas.

Observação

O objeto de seção já deve existir para que o arquivo seja pré-buscado. Um identificador de seção pode ser obtido chamando ZwCreateSection.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)