Condividi tramite

Metodo IHostMemoryManager::VirtualQuery

  • Articolo

Funge da wrapper logico per la funzione Win32 corrispondente. L'implementazione win32 di VirtualQuery recupera informazioni su un intervallo di pagine nello spazio indirizzi virtuale del processo di chiamata.

Sintassi

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

Parametri

lpAddress
[in] Puntatore all'indirizzo in memoria virtuale da eseguire query.

lpBuffer
[out] Puntatore a una struttura contenente informazioni sull'area di memoria specificata.

dwLength
[in] Dimensioni, in byte, del buffer a cui lpBuffer punta.

pResult
[out] Puntatore al numero di byte restituiti dal buffer delle informazioni.

Valore restituito

HRESULT Descrizione
S_OK VirtualQuery restituito correttamente.
HOST_E_CLRNOTAVAILABLE Common Language Runtime (CLR) non è stato caricato in un processo oppure CLR si trova in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata.
HOST_E_TIMEOUT Timeout della chiamata.
HOST_E_NOT_OWNER Il chiamante non possiede il blocco.
HOST_E_ABANDONED Un evento è stato annullato mentre un thread bloccato o fibra era in attesa su di esso.
E_FAIL Si è verificato un errore irreversibile sconosciuto. Quando un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE.

Commenti

VirtualQuery fornisce informazioni su un intervallo di pagine nello spazio indirizzi virtuale del processo chiamante. Questa implementazione imposta il valore del pResult parametro sul numero di byte restituiti nel buffer delle informazioni e restituisce un valore HRESULT. Nella funzione Win32 VirtualQuery il valore restituito è la dimensione del buffer. Per altre informazioni, vedere la documentazione di Windows Platform.

Importante

L'implementazione del sistema operativo di VirtualQuery non comporta deadlock e può essere eseguita al completamento con thread casuali sospesi nel codice utente. Prestare attenzione quando si implementa una versione ospitata di questo metodo.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile da 2.0

Vedi anche