IHostMemoryManager::VirtualQuery, méthode

Article
08/10/2011

Sert de wrapper logique pour la fonction Win32 correspondante. L'implémentation Win32 de VirtualQuery ou récupère des informations sur une page de plages dans l'espace d'adressage virtuel du processus appelant.

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 à propos de la région de mémoire spécifiée.
dwLength
[in] Taille, en octets, de la mémoire tampon qui pointe vers lpBuffer.
pResult
[out] Pointeur vers le nombre d'octets retourné par la mémoire tampon d'informations.

Valeur de retour

HRESULT	Description
S_OK	VirtualQuery a été retourné avec succès.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.
HOST_E_TIMEOUT	L'appel a expiré.
HOST_E_NOT_OWNER	L'appelant ne possède pas le verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.

Notes

VirtualQuery fournit des informations à propos d'une plage de pages dans l'espace d'adressage virtuel du processus appelant. Cette implémentation définit la valeur du paramètre pResult au nombre d'octets retournés dans la mémoire tampon d'informations et retourne une valeur HRESULT. Dans la fonction de Win32 VirtualQuery, la valeur de retour 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 intégralement avec des threads aléatoires interrompus dans le code utilisateur.Procédez avec précaution lors de l'implémentation d'une version hébergée de cette méthode.

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MSCorEE.dll

Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Voir aussi

Référence

IHostMemoryManager, interface

Partager via