Função QueryVirtualMemoryInformation (memoryapi.h)
A função QueryVirtualMemoryInformation retorna informações sobre uma página ou um conjunto de páginas dentro do espaço de endereço virtual do processo especificado.
Sintaxe
BOOL QueryVirtualMemoryInformation(
[in] HANDLE Process,
[in] const VOID *VirtualAddress,
[in] WIN32_MEMORY_INFORMATION_CLASS MemoryInformationClass,
[out] PVOID MemoryInformation,
[in] SIZE_T MemoryInformationSize,
[out, optional] PSIZE_T ReturnSize
);
Parâmetros
[in] Process
Um identificador para o processo em cujo contexto as páginas a serem consultadas residem.
[in] VirtualAddress
O endereço da região das páginas a serem consultadas. Esse valor é arredondado para baixo para o próximo limite host-page-address.
[in] MemoryInformationClass
A classe de informações de memória sobre a qual recuperar informações. O único valor com suporte é MemoryRegionInfo.
[out] MemoryInformation
Um ponteiro para um buffer que recebe as informações especificadas.
Se o parâmetro MemoryInformationClass tiver um valor de MemoryRegionInfo, esse parâmetro deverá apontar para uma estrutura WIN32_MEMORY_REGION_INFORMATION .
[in] MemoryInformationSize
Especifica o comprimento em bytes do buffer de informações de memória.
[out, optional] ReturnSize
Um ponteiro opcional que, se especificado, recebe o número de bytes colocados no buffer de informações de memória.
Retornar valor
Retorna TRUE com êxito. Retorna FALSE para falha. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Se o parâmetro MemoryInformationClass tiver um valor de MemoryRegionInfo, o parâmetro MemoryInformation deverá apontar para uma estrutura WIN32_MEMORY_REGION_INFORMATION . O parâmetro VirtualAddress deve apontar para um endereço dentro de uma alocação de memória válida. Se o parâmetro VirtualAddress apontar para uma região de memória não alocada, a função falhará.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 1607 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2016 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | memoryapi.h (inclua Windows.h) |
| Biblioteca | Onecore.lib |
| DLL | Api-ms-win-core-memory-l1-1-4.dll |