Condividi tramite

Metodo IHostMemoryManager::RegisterMemoryNotificationCallback

  • Articolo

Registra un puntatore a una funzione di callback richiamata dall'host per notificare a Common Language Runtime (CLR) il carico di memoria corrente nel computer.

Sintassi

HRESULT RegisterMemoryNotificationCallback (  
    [in] ICLRMemoryNotificationCallback* pCallback  
);

Parametri

pCallback
[in] Puntatore di interfaccia a un'istanza ICLRMemoryNotificationCallback implementata da CLR.

Valore restituito

HRESULT Descrizione
S_OK RegisterMemoryNotificationCallback restituito correttamente.
HOST_E_CLRNOTAVAILABLE CLR non è stato caricato in un processo oppure CLR si trova in uno stato in cui non può 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 durante l'attesa di un thread o di una fibra bloccata.
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

Poiché l'interfaccia ICLRMemoryNotificationCallback definisce un solo metodo (ICLRMemoryNotificationCallback::OnMemoryNotification) e poiché pCallback è un puntatore a un'istanza ICLRMemoryNotificationCallback fornita da CLR, la registrazione è in effetti per la funzione di callback stessa. L'host richiama per segnalare OnMemoryNotification le condizioni di utilizzo elevato della memoria anziché usare la funzione Win32 CreateMemoryResourceNotification standard. Per altre informazioni, vedere la documentazione della piattaforma Windows.

Nota

Chiamate a OnMemoryNotification non bloccare mai. Tornano sempre immediatamente.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile dalla versione 2.0

Vedi anche