Compartilhar via


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

Confira também

Obter Último Erro

MEMORY_BASIC_INFORMATION

WIN32_MEMORY_REGION_INFORMATION