Sdílet prostřednictvím

IHostMemoryManager::RegisterMemoryNotificationCallback – metoda

Registruje ukazatel na funkci zpětného volání, kterou hostitel vyvolá, aby upozornil modul CLR (Common Language Runtime) na aktuální zatížení paměti v počítači.

Syntaxe

HRESULT RegisterMemoryNotificationCallback (  
    [in] ICLRMemoryNotificationCallback* pCallback  
);

Parametry

pCallback
[v] Ukazatel rozhraní ICLRMemoryNotificationCallback instance, která je implementována CLR.

Návratová hodnota

HRESULT Description
S_OK RegisterMemoryNotificationCallback úspěšně vráceno.
HOST_E_CLRNOTAVAILABLE ClR nebyl načten do procesu nebo clr je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání.
HOST_E_TIMEOUT Časový limit hovoru vypršel.
HOST_E_NOT_OWNER Volající zámek nevlastní.
HOST_E_ABANDONED Událost byla zrušena, zatímco na ni čekalo blokované vlákno nebo vlákno.
E_FAIL Došlo k neznámému závažnému selhání. Když metoda vrátí E_FAIL, clr již není možné v rámci procesu použít. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE.

Poznámky

Vzhledem k tomu, že ICLRMemoryNotificationCallback rozhraní definuje pouze jednu metodu (ICLRMemoryNotificationCallback::OnMemoryNotification) a protože pCallback je ukazatel na ICLRMemoryNotificationCallback instanci poskytovanou CLR, registrace je ve skutečnosti pro funkci zpětného volání samotná. Hostitel vyvolá, OnMemoryNotification aby hlásil podmínky zatížení paměti místo použití standardní funkce Win32 CreateMemoryResourceNotification . Další informace najdete v dokumentaci k platformě Windows.

Poznámka

Volání, která nikdy OnMemoryNotification neblokují. Vždy se okamžitě vrátí.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MSCorEE.h

Knihovny: Zahrnutý jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Viz také

  • Last updated on