Udostępnij za pośrednictwem


IHostMemoryManager::VirtualQuery — Metoda

Służy jako logiczne otoki dla odpowiedniej funkcji Win32. Implementacja VirtualQuery win32 pobiera informacje o zakresie stron w wirtualnej przestrzeni adresowej procesu wywoływania.

Składnia

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

Parametry

lpAddress
[in] Wskaźnik do adresu w pamięci wirtualnej do odpytowania.

lpBuffer
[out] Wskaźnik do struktury zawierającej informacje o określonym regionie pamięci.

dwLength
[in] Rozmiar w bajtach buforu, który lpBuffer wskazuje.

pResult
[out] Wskaźnik do liczby bajtów zwracanych przez bufor informacji.

Wartość zwracana

HRESULT Opis
S_OK VirtualQuery zwrócone pomyślnie.
HOST_E_CLRNOTAVAILABLE Środowisko uruchomieniowe języka wspólnego (CLR) nie zostało załadowane do procesu lub clR jest w stanie, w którym nie może uruchomić kodu zarządzanego ani pomyślnie przetworzyć wywołania.
HOST_E_TIMEOUT Upłynął limit czasu wywołania.
HOST_E_NOT_OWNER Obiekt wywołujący nie jest właścicielem blokady.
HOST_E_ABANDONED Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie.
E_FAIL Wystąpił nieznany katastrofalny błąd. Gdy metoda zwraca E_FAIL, clR nie będzie już można jej używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE.

Uwagi

VirtualQuery Zawiera informacje o zakresie stron w wirtualnej przestrzeni adresowej procesu wywoływania. Ta implementacja ustawia wartość parametru pResult na liczbę bajtów zwróconych w buforze informacji i zwraca wartość HRESULT. W funkcji Win32 VirtualQuery zwracana wartość jest rozmiarem buforu. Aby uzyskać więcej informacji, zobacz dokumentację platformy systemu Windows.

Ważne

Implementacja VirtualQuery systemu operacyjnego nie powoduje zakleszczenia i może zostać uruchomiona do ukończenia z losowymi wątkami zawieszonymi w kodzie użytkownika. Podczas implementowania hostowanej wersji tej metody należy zachować szczególną ostrożność.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: MSCorEE.h

Biblioteki: Uwzględnione jako zasób w MSCorEE.dll

wersje .NET Framework: dostępne od wersji 2.0

Zobacz też