Función QueryWorkingSetEx (psapi.h)
Recupera información extendida sobre las páginas en direcciones virtuales específicas del espacio de direcciones del proceso especificado.
Sintaxis
BOOL QueryWorkingSetEx(
[in] HANDLE hProcess,
[in, out] PVOID pv,
[in] DWORD cb
);
Parámetros
[in] hProcess
Identificador del proceso. El identificador debe tener el derecho de acceso PROCESS_QUERY_INFORMATION . Para obtener más información, consulte Derechos de acceso y seguridad de procesos.
[in, out] pv
Puntero a una matriz de estructuras de PSAPI_WORKING_SET_EX_INFORMATION . En la entrada, cada elemento de la matriz especifica una dirección virtual de interés. En la salida, cada elemento de la matriz recibe información sobre la página virtual correspondiente.
[in] cb
Tamaño del búfer pv , en bytes.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
A diferencia de la función QueryWorkingSet , que se limita al conjunto de trabajo del proceso de destino, la función QueryWorkingSetEx se puede usar para consultar direcciones que no están en el conjunto de trabajo del proceso, pero que siguen formando parte del proceso, como AWE y páginas grandes.
A partir de Windows 7 y Windows Server 2008 R2, Psapi.h establece números de versión para las funciones psapi. El número de versión de PSAPI afecta al nombre usado para llamar a la función y la biblioteca que debe cargar un programa.
Si PSAPI_VERSION es 2 o superior, esta función se define como K32QueryWorkingSetEx en Psapi.h y exportada en Kernel32.lib y Kernel32.dll. Si PSAPI_VERSION es 1, esta función se define como QueryWorkingSetEx en Psapi.h y exportada en Psapi.lib y Psapi.dll como contenedor que llama a K32QueryWorkingSetEx.
Los programas que deben ejecutarse en versiones anteriores de Windows, así como Windows 7 y versiones posteriores siempre deben llamar a esta función como QueryWorkingSetEx. Para garantizar la resolución correcta de símbolos, agregue Psapi.lib a la macro TARGETLIBS y compile el programa con "–DPSAPI_VERSION=1". Para usar la vinculación dinámica en tiempo de ejecución, cargue Psapi.dll.
Ejemplos
Para obtener un ejemplo, vea Asignar memoria desde un nodo NUMA.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista, Windows XP Professional x64 Edition [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008, Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | psapi.h |
| Library | Kernel32.lib en Windows 7 y Windows Server 2008 R2; Psapi.lib (si PSAPI_VERSION=1) en Windows 7 y Windows Server 2008 R2; Psapi.lib en Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP |
| Archivo DLL | Kernel32.dll en Windows 7 y Windows Server 2008 R2; Psapi.dll (si PSAPI_VERSION=1) en Windows 7 y Windows Server 2008 R2; Psapi.dll en Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP |