Fonction QueryWorkingSet (psapi.h)
Récupère des informations sur les pages actuellement ajoutées à l’ensemble de travail du processus spécifié.
Pour récupérer des informations sur le jeu de travail pour un sous-ensemble d’adresses virtuelles, ou pour récupérer des informations sur les pages qui ne font pas partie de l’ensemble de travail (par exemple, AWE ou grandes pages), utilisez la fonction QueryWorkingSetEx .
Syntaxe
BOOL QueryWorkingSet(
[in] HANDLE hProcess,
[out] PVOID pv,
[in] DWORD cb
);
Paramètres
[in] hProcess
Handle du processus. Le handle doit disposer des droits d’accès PROCESS_QUERY_INFORMATION et PROCESS_VM_READ . Pour plus d’informations, consultez Traiter les droits de sécurité et d’accès.
[out] pv
Pointeur vers la mémoire tampon qui reçoit les informations. Pour plus d’informations, consultez PSAPI_WORKING_SET_INFORMATION.
Si la mémoire tampon pointée par le paramètre pv n’est pas assez grande pour contenir toutes les entrées du jeu de travail pour le processus cible, la fonction échoue avec ERROR_BAD_LENGTH. Dans ce cas, le membre NumberOfEntries de la structure PSAPI_WORKING_SET_INFORMATION est défini sur le nombre d’entrées requis, mais la fonction ne retourne pas d’informations sur les entrées du jeu de travail.
[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
À compter de Windows 7 et Windows Server 2008 R2, Psapi.h établit les 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 est égal ou supérieur à 2, cette fonction est définie comme K32QueryWorkingSet dans Psapi.h et exportée dans Kernel32.lib et Kernel32.dll. Si PSAPI_VERSION est 1, cette fonction est définie comme QueryWorkingSet dans Psapi.h et exportée dans Psapi.lib et Psapi.dll en tant que wrapper qui appelle K32QueryWorkingSet.
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 queryWorkingSet. 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [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 |