Função QueryWorkingSetEx (psapi.h)

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

Confira também

EnumProcesses

Funções PSAPI

PSAPI_WORKING_SET_EX_INFORMATION

Informações do conjunto de trabalho