VirtualQuery

9/8/2008

Essa função fornece informações sobre um intervalo de páginas a espaço de endereço virtual da processo de chamada.

Syntax

DWORD VirtualQuery(
  LPCVOID lpAddress,
  PMEMORY_BASIC_INFORMATION lpBuffer,
  DWORD dwLength
);

Parameters

• lpAddress
  [no] Ponteiro para o endereço de base da região de páginas a ser consultado.

  Esse valor é arredondado Down to o próximo limite página.

  Para determinar o tamanho de uma página no computador a hospedar, use a função GetSystemInfo.

• lpBuffer
  [out] Ponteiro para uma estrutura MEMORY_BASIC_INFORMATION em quais informações sobre a página especificada intervalo será retornado.

• dwLength
  [no] Especifica o tamanho, em bytes, da reserva apontado pelo lpBuffer parâmetro.

Return Value

O número de bytes retornada na reserva de informações indica sucesso.

Remarks

VirtualQuery Fornece informações sobre uma região de páginas consecutivas começando um endereço especificado que compartilhar o seguinte atributos:

• O estado de todas as páginas é o mesmo que os sinalizadores MEM_COMMIT, MEM_RESERVE, MEM_FREE, MEM_PRIVATE, MEM_MAPPED ou MEM_IMAGE.
• Se a página inicial não for livre, todas as páginas na região são parte a mesma alocação inicial de páginas reservadas por um chamar a função de VirtualAlloc.
• A acessar de todas as páginas é o mesmo que os sinalizadores PAGE_READONLY, PAGE_READWRITE, PAGE_NOACCESS, PAGE_WRITECOPY, PAGE_EXECUTE, PAGE_EXECUTE_READ, PAGE_EXECUTE_READWRITE, PAGE_EXECUTE_WRITECOPY, PAGE_GUARD ou PAGE_NOCACHE.

O VirtualQuery função determina os atributos da primeira página na região e, em seguida, examina páginas subseqüentes até que ele verifica o intervalo inteiro de páginas ou até que ele encontra uma página com um conjunto de atributos não correspondentes.

A função retorna os atributos e o tamanho, em bytes, da região de páginas com compatível atributos. De exemplo, se houver uma região MB 20 de livre memória e VirtualQuery é chamado em uma página que é 10 MB para a região, a função obtém um estado de MEM_FREE e um tamanho de 10 MB.

Requirements

Header	winbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Memory Management Functions
GetSystemInfo
VirtualAlloc
MEMORY_BASIC_INFORMATION