IHostMemoryManager::VirtualQuery, méthode
Sert de wrapper logique pour la fonction Win32 correspondante. L’implémentation Win32 de VirtualQuery récupère des informations sur une plage de pages dans l’espace d’adressage virtuel du processus appelant.
Syntaxe
HRESULT VirtualQuery (
[in] void* lpAddress,
[out] void* lpBuffer,
[in] SIZE_T dwLength,
[out] SIZE_T* pResult
);
Paramètres
lpAddress
[in] Pointeur vers l’adresse dans la mémoire virtuelle à interroger.
lpBuffer
[out] Pointeur vers une structure qui contient des informations sur la région de mémoire spécifiée.
dwLength
[in] Taille, en octets, du tampon vers lequel lpBuffer pointe.
pResult
[out] Pointeur vers le nombre d’octets retournés par le tampon d’informations.
Valeur de retour
| HRESULT | Description |
|---|---|
| S_OK | VirtualQuery retourné. |
| HOST_E_CLRNOTAVAILABLE | Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès. |
| HOST_E_TIMEOUT | L’appel a expiré. |
| HOST_E_NOT_OWNER | L’appelant n’est pas propriétaire du verrou. |
| HOST_E_ABANDONED | Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait. |
| E_FAIL | Une défaillance catastrophique inconnue s’est produite. Quand une méthode retourne E_FAIL, le CLR n’est plus utilisable au sein du processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE. |
Notes
VirtualQuery fournit des informations sur une plage de pages dans l’espace d’adressage virtuel du processus appelant. Cette implémentation définit la valeur du paramètre pResult sur le nombre d’octets retournés dans le tampon d’informations et retourne une valeur HRESULT. Dans la fonction VirtualQuery Win32, la valeur renvoyée est la taille de la mémoire tampon. Pour plus d’informations, consultez la documentation de la plateforme Windows.
Important
L’implémentation du système d’exploitation de VirtualQuery n’entraîne pas d’interblocage et peut s’exécuter jusqu’à complétion avec des threads aléatoires suspendus dans le code utilisateur. Soyez très prudent lors de l’implémentation d’une version hébergée de cette méthode.
Spécifications
Plateformes : Consultez Configuration requise.
En-tête : MSCorEE.h
Bibliothèque : incluse en tant que ressource dans MsCorEE.dll
Versions de .NET Framework : Disponible depuis la version 2.0
