Methode IHostMemoryManager::VirtualQuery
Fungeert als een logische wrapper voor de bijbehorende Win32-functie. De Win32-implementatie van VirtualQuery haalt informatie op over een reeks pagina's in de virtuele adresruimte van het aanroepende proces.
Syntaxis
HRESULT VirtualQuery (
[in] void* lpAddress,
[out] void* lpBuffer,
[in] SIZE_T dwLength,
[out] SIZE_T* pResult
);
Parameters
lpAddress
[in] Een verwijzing naar het adres in het virtuele geheugen dat moet worden opgevraagd.
lpBuffer
[uit] Een verwijzing naar een structuur die informatie bevat over de opgegeven geheugenregio.
dwLength
[in] De grootte, in bytes, van de buffer waarnaar lpBuffer verwijst.
pResult
[uit] Een verwijzing naar het aantal bytes dat door de informatiebuffer wordt geretourneerd.
Retourwaarde
| HRESULT | Beschrijving |
|---|---|
| S_OK | VirtualQuery is geretourneerd. |
| HOST_E_CLRNOTAVAILABLE | De Common Language Runtime (CLR) is niet geladen in een proces of de CLR bevindt zich in een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt. |
| HOST_E_TIMEOUT | Er is een time-out opgetreden voor het gesprek. |
| HOST_E_NOT_OWNER | De beller is niet de eigenaar van het vergrendelingsslot. |
| HOST_E_ABANDONED | Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of vezel op wachtte. |
| E_FAIL | Er is een onbekende catastrofale fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE. |
Opmerkingen
VirtualQuery biedt informatie over een bereik van pagina's in de virtuele adresruimte van het aanroepende proces. Deze implementatie stelt de waarde van de pResult parameter in op het aantal bytes dat wordt geretourneerd in de informatiebuffer en retourneert een HRESULT-waarde. In de functie Win32 VirtualQuery is de retourwaarde de buffergrootte. Zie de windows-platformdocumentatie voor meer informatie.
Belangrijk
De implementatie van het VirtualQuery besturingssysteem loopt niet vast en kan tot voltooiing worden uitgevoerd met willekeurige threads die in de gebruikerscode zijn onderbroken. Wees voorzichtig bij het implementeren van een gehoste versie van deze methode.
Vereisten
Platforms: Zie Systeemvereisten.
Header: MSCorEE.h
Bibliotheek: Opgenomen als een resource in MSCorEE.dll
.NET Framework versies: beschikbaar sinds 2.0
