IHostMemoryManager::VirtualQuery metódus

A megfelelő Win32 függvény logikai burkolójaként szolgál. A Win32-implementáció VirtualQuery lekéri a hívási folyamat virtuális címterében található oldalak egy tartományára vonatkozó információkat.

Szintaxis

HRESULT VirtualQuery (  
    [in]  void*    lpAddress,  
    [out] void*    lpBuffer,  
    [in]  SIZE_T   dwLength,  
    [out] SIZE_T*  pResult  
);  

Paraméterek

lpAddress
[in] A lekérdezendő virtuális memória címére mutató mutató.

lpBuffer
[kifelé] A megadott memóriarégióra vonatkozó információkat tartalmazó struktúra mutatója.

dwLength
[in] A puffer mérete bájtban, amely lpBuffer a következőre mutat.

pResult
[kifelé] Mutató az információs puffer által visszaadott bájtok számára.

Visszatérési érték

HRESULT	Description
S_OK	VirtualQuery sikeresen visszaadott.
HOST_E_CLRNOTAVAILABLE	A közös nyelvi futtatókörnyezet (CLR) nincs betöltve egy folyamatba, vagy a CLR olyan állapotban van, amelyben nem tudja futtatni a felügyelt kódot, vagy nem tudja sikeresen feldolgozni a hívást.
HOST_E_TIMEOUT	A hívás túllépte az időkorlátot.
HOST_E_NOT_OWNER	A hívó nem rendelkezik a zárral.
HOST_E_ABANDONED	Egy esemény megszakadt, miközben egy blokkolt szál vagy szál várakozott rá.
E_FAIL	Ismeretlen katasztrofális hiba történt. Amikor egy metódus E_FAIL ad vissza, a CLR már nem használható a folyamaton belül. Az üzemeltetési módszerekre irányuló későbbi hívások HOST_E_CLRNOTAVAILABLE adnak vissza.

Megjegyzések

VirtualQuery információt nyújt a hívási folyamat virtuális címterében található oldalak egy tartományáról. Ez az implementáció a paraméter értékét az pResult információs pufferben visszaadott bájtok számára állítja, és egy HRESULT értéket ad vissza. A Win32 VirtualQuery függvényben a visszatérési érték a pufferméret. További információt a Windows Platform dokumentációjában talál.

Fontos

Az operációs rendszer implementációja VirtualQuery nem jár holtponttal, és a felhasználói kódban felfüggesztett véletlenszerű szálakkal futtatható. A metódus üzemeltetett verziójának megvalósításakor nagy körültekintéssel járjon el.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: MSCorEE.h

Könyvtár: Erőforrásként szerepel a MSCorEE.dll

.NET-keretrendszer verziók: 2.0 óta érhető el

Lásd még

• IHostMemoryManager felület