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 ser pré-buscada.

Valor de retorno

MmPrefetchPages retorna STATUS_SUCCESS ou um status de erro apropriado que representa o status final de conclusão da operação. Os códigos de status de erro possíveis 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 de Listas de Leitura não é prefetchável (por exemplo, uma seção com backup de arquivo de página ou físico) 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.

Observações

MmPrefetchPages lê páginas do armazenamento secundário descritas 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", serão emitidas leituras separadas.

Nota

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
de cliente com suporte mínimo	Windows XP
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h, Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)