Função ZwSetInformationVirtualMemory (ntifs.h)

A rotina ZwSetInformationVirtualMemory executa uma operação em uma lista especificada de intervalos de endereços no espaço de endereço do usuário de um processo.

Sintaxe

NTSYSAPI NTSTATUS ZwSetInformationVirtualMemory(
  [in] HANDLE                           ProcessHandle,
  [in] VIRTUAL_MEMORY_INFORMATION_CLASS VmInformationClass,
  [in] ULONG_PTR                        NumberOfEntries,
  [in] PMEMORY_RANGE_ENTRY              VirtualAddresses,
  [in] PVOID                            VmInformation,
  [in] ULONG                            VmInformationLength
);

Parâmetros

[in] ProcessHandle

Especifica um identificador aberto para o processo no contexto do qual a operação deve ser executada. Esse identificador não pode ser inválido. Use a macro NtCurrentProcess , definida em Ntddk.h, para especificar o processo atual.

[in] VmInformationClass

Especifica o tipo de operação a ser executada. Defina como VmPrefetchInformation definido na enumeração VIRTUAL_MEMORY_INFORMATION_CLASS , consulte ntddk.h.

[in] NumberOfEntries

Número de entradas na matriz apontada pelo parâmetro VirtualAddresses . Esse parâmetro não pode ser 0.

[in] VirtualAddresses

Ponteiro para uma matriz de estruturas MEMORY_RANGE_ENTRY em que cada entrada especifica um intervalo de endereços virtuais a ser processado. Os intervalos de endereços virtuais podem abranger qualquer parte do espaço de endereço do processo acessível pelo processo de destino.

[in] VmInformation

Um ponteiro para um buffer que contém informações de memória. O formato e o conteúdo do buffer dependem da classe de informações especificada.

Se VmInformationClass for VmPrefetchInformation, esse parâmetro não poderá ser NULL e deve apontar para uma variável ULONG definida como 0.

[in] VmInformationLength

O tamanho do buffer apontado por VmInformation.

Se VmInformationClass for VmPrefetchInformation, isso deverá ser sizeof (ULONG).

Valor retornado

ZwSetInformationVirtualMemory retorna STATUS_SUCCESS com êxito ou o código de erro NTSTATUS apropriado sobre falha.

Comentários

A rotina ZwSetInformationVirtualMemory é chamada por drivers que sabem o conjunto de endereços que estarão acessando. Se é provável que esses endereços não sejam mais residentes na memória (ou seja, eles foram chamados para o disco), chamar essa rotina nesses intervalos de endereços antes que o acesso reduza a latência geral, pois ele traz com eficiência esses intervalos de endereços do disco usando solicitações de E/S grandes e simultâneas sempre que possível.

ZwSetInformationVirtualMemory permite que os drivers façam uso eficiente do hardware de disco emitindo E/S grandes e simultâneas sempre que possível quando o driver fornece uma lista de intervalos de endereços de processo que serão acessados. Mesmo para um único intervalo de endereços (por exemplo, um mapeamento de arquivo), a rotina pode fornecer melhorias de desempenho emitindo uma única E/S grande em vez de muitos E/S menores que seriam emitidos por meio de falhas de página.

Os drivers chamam essa rotina puramente para otimização de desempenho: a pré-busca não é necessária para acessar os intervalos de endereços de destino. A memória pré-fé não é adicionada ao conjunto de trabalho do processo de destino; ele é armazenado em cache na memória física. Quando os intervalos de endereços pré-buscados são acessados pelo processo de destino, eles são adicionados ao conjunto de trabalho.

Como essa chamada não é necessária para a operação correta do driver, ela é tratada como uma dica forte pelo sistema e está sujeita a restrições de memória física usuais em que pode falhar completamente ou parcialmente em condições de baixa memória. Ele também pode criar pressão de memória se for chamado com grandes intervalos de endereços, portanto, os aplicativos devem apenas pré-executar intervalos de endereços que eles realmente usarão.

Requisitos

   
Cliente mínimo com suporte Disponível a partir do Windows 10, versão 1511.
Plataforma de Destino Universal
Cabeçalho ntifs.h (include Ntddk.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade DDI HwStorPortProhibitedDIs, PowerIrpDDis