IHostMemoryManager::VirtualQuery-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Dient als logischer Wrapper für die entsprechende Win32-Funktion. Die Win32-Implementierung von VirtualQuery ruft Informationen über einen Seitenbereich im virtuellen Adressbereich des aufrufenden Prozesses ab.

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

Parameter

lpAddress
[in] Ein Zeiger auf die Adresse im virtuellen Arbeitsspeicher, der abgefragt werden soll.
lpBuffer
[out] Ein Zeiger auf eine Struktur, die Informationen zu dem angegebenen Arbeitsspeicherbereich enthält.
dwLength
[in] Die Größe des Puffers in Bytes, auf den dieser lpBuffer zeigt.
pResult
[out] Ein Zeiger auf die Anzahl von Bytes, die vom Informationspuffer zurückgegeben werden.

Rückgabewert

HRESULT	Beschreibung
S_OK	VirtualQuery kehrte erfolgreich zurück.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

VirtualQuery stellt Informationen zu einem Seitenbereich im virtuellen Adressraum des aufrufenden Prozesses bereit. Diese Implementierung legt den Wert des Parameters pResult auf die Anzahl von Byte fest, die vom Informationspuffer zurückgegeben werden, und gibt einen HRESULT-Wert zurück. In der Win32 VirtualQuery-Funktion ist der Rückgabewert die Puffergröße. Weitere Informationen finden Sie in der Dokumentation zur Windows-Plattform.

Wichtiger Hinweis:
In der Implementierung des Betriebssystems von VirtualQuery tritt kein Deadlock auf, sodass sie bis zum Abschluss mit zufällig angehaltenen Threads im Benutzercode ausgeführt werden kann. Seien Sie äußerst vorsichtig, wenn Sie eine gehostete Version dieser Methode implementieren.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MSCorEE.idl

Bibliothek: als Ressource in MSCorEE.dll enthalten

.NET Framework-Versionen: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Siehe auch

Referenz

IHostMemoryManager

Freigeben über