Fonction QueryWorkingSetEx (psapi.h)
Récupère des informations étendues sur les pages à des adresses virtuelles spécifiques dans l’espace d’adressage du processus spécifié.
Syntaxe
BOOL QueryWorkingSetEx(
[in] HANDLE hProcess,
[in, out] PVOID pv,
[in] DWORD cb
);
Paramètres
[in] hProcess
Handle du processus. Le handle doit avoir le droit d’accès PROCESS_QUERY_INFORMATION . Pour plus d’informations, consultez Droits d’accès et de sécurité des processus.
[in, out] pv
Pointeur vers un tableau de structures PSAPI_WORKING_SET_EX_INFORMATION . Lors de l’entrée, chaque élément du tableau spécifie une adresse virtuelle intéressante. Lors de la sortie, chaque élément du tableau reçoit des informations sur la page virtuelle correspondante.
[in] cb
Taille de la mémoire tampon pv , en octets.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Contrairement à la fonction QueryWorkingSet , qui est limitée à l’ensemble de travail du processus cible, la fonction QueryWorkingSetEx peut être utilisée pour interroger des adresses qui ne sont pas dans le jeu de travail du processus, mais qui font toujours partie du processus, telles que AWE et les pages volumineuses.
À compter de Windows 7 et Windows Server 2008 R2, Psapi.h établit des numéros de version pour les fonctions PSAPI. Le numéro de version PSAPI affecte le nom utilisé pour appeler la fonction et la bibliothèque qu’un programme doit charger.
Si PSAPI_VERSION a la valeur 2 ou supérieure, cette fonction est définie comme K32QueryWorkingSetEx dans Psapi.h et exportée dans Kernel32.lib et Kernel32.dll. Si PSAPI_VERSION a la valeur 1, cette fonction est définie comme QueryWorkingSetEx dans Psapi.h et exportée dans Psapi.lib et Psapi.dll en tant que wrapper qui appelle K32QueryWorkingSetEx.
Les programmes qui doivent s’exécuter sur des versions antérieures de Windows ainsi que Sur Windows 7 et versions ultérieures doivent toujours appeler cette fonction QueryWorkingSetEx. Pour garantir une résolution correcte des symboles, ajoutez Psapi.lib à la macro TARGETLIBS et compilez le programme avec « –DPSAPI_VERSION=1 ». Pour utiliser la liaison dynamique au moment de l’exécution, chargez Psapi.dll.
Exemples
Pour obtenir un exemple, consultez Allocation de mémoire à partir d’un nœud NUMA.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista, Windows XP Professionnel Édition x64 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | psapi.h |
| Bibliothèque | Kernel32.lib sur Windows 7 et Windows Server 2008 R2 ; Psapi.lib (si PSAPI_VERSION=1) sur Windows 7 et Windows Server 2008 R2 ; Psapi.lib sur Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP |
| DLL | Kernel32.dll sur Windows 7 et Windows Server 2008 R2 ; Psapi.dll (si PSAPI_VERSION=1) sur Windows 7 et Windows Server 2008 R2 ; Psapi.dll sur Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP |