Função QueryWorkingSetEx (psapi.h)

  • Artigo

Recupera informações estendidas sobre as páginas em endereços virtuais específicos no espaço de endereço do processo especificado.

Sintaxe

BOOL QueryWorkingSetEx(
  [in]      HANDLE hProcess,
  [in, out] PVOID  pv,
  [in]      DWORD  cb
);

Parâmetros

[in] hProcess

Um identificador para o processo. O identificador deve ter o direito de acesso PROCESS_QUERY_INFORMATION . Para obter mais informações, consulte Direitos de acesso e segurança do processo.

[in, out] pv

Um ponteiro para uma matriz de estruturas PSAPI_WORKING_SET_EX_INFORMATION . Na entrada, cada item na matriz especifica um endereço virtual de interesse. Na saída, cada item na matriz recebe informações sobre a página virtual correspondente.

[in] cb

O tamanho do buffer pv , em bytes.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Ao contrário da função QueryWorkingSet , que é limitada ao conjunto de trabalho do processo de destino, a função QueryWorkingSetEx pode ser usada para consultar endereços que não estão no conjunto de trabalho do processo, mas ainda fazem parte do processo, como AWE e páginas grandes.

A partir do Windows 7 e do Windows Server 2008 R2, o Psapi.h estabelece números de versão para as funções PSAPI. O número de versão do PSAPI afeta o nome usado para chamar a função e a biblioteca que um programa deve carregar.

Se PSAPI_VERSION for 2 ou maior, essa função será definida como K32QueryWorkingSetEx em Psapi.h e exportada em Kernel32.lib e Kernel32.dll. Se PSAPI_VERSION for 1, essa função será definida como QueryWorkingSetEx no Psapi.h e exportada em Psapi.lib e Psapi.dll como um wrapper que chama K32QueryWorkingSetEx.

Os programas que devem ser executados em versões anteriores do Windows, bem como no Windows 7 e versões posteriores, sempre devem chamar essa função como QueryWorkingSetEx. Para garantir a resolução correta de símbolos, adicione Psapi.lib à macro TARGETLIBS e compile o programa com "–DPSAPI_VERSION=1". Para usar a vinculação dinâmica em tempo de execução, carregue Psapi.dll.

Exemplos

Para obter um exemplo, consulte Alocando memória de um nó NUMA.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP Professional x64 Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008, Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho psapi.h
Biblioteca Kernel32.lib no Windows 7 e Windows Server 2008 R2; Psapi.lib (se PSAPI_VERSION=1) no Windows 7 e Windows Server 2008 R2; Psapi.lib no Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP
DLL Kernel32.dll no Windows 7 e no Windows Server 2008 R2; Psapi.dll (se PSAPI_VERSION=1) no Windows 7 e no Windows Server 2008 R2; Psapi.dll no Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP

Confira também

EnumProcesses

Funções PSAPI

PSAPI_WORKING_SET_EX_INFORMATION

Informações do conjunto de trabalho