Dela via

IHostMemoryManager::RegisterMemoryNotificationCallback-metod

Registrerar en pekare till en motringningsfunktion som värden anropar för att meddela CLR (Common Language Runtime) om den aktuella minnesbelastningen på datorn.

Syntax

HRESULT RegisterMemoryNotificationCallback (  
    [in] ICLRMemoryNotificationCallback* pCallback  
);

Parametrar

pCallback
[i] En gränssnittspekare till en ICLRMemoryNotificationCallback-instans som implementeras av CLR.

Returvärde

HRESULT Description
S_OK RegisterMemoryNotificationCallback returnerades korrekt.
HOST_E_CLRNOTAVAILABLE CLR har inte lästs in i en process, eller så är CLR i ett tillstånd där den inte kan köra hanterad kod eller bearbeta anropet.
HOST_E_TIMEOUT Samtalets tidsgräns överst.
HOST_E_NOT_OWNER Anroparen äger inte låset.
HOST_E_ABANDONED En händelse avbröts medan en blockerad tråd eller fiber väntade på den.
E_FAIL Ett okänt oåterkalleligt fel inträffade. När en metod returnerar E_FAIL kan CLR inte längre användas i processen. Efterföljande anrop till värdmetoder returnerar HOST_E_CLRNOTAVAILABLE.

Kommentarer

ICLRMemoryNotificationCallback Eftersom gränssnittet bara definierar en metod (ICLRMemoryNotificationCallback::OnMemoryNotification), och eftersom pCallback är en pekare till en ICLRMemoryNotificationCallback instans som tillhandahålls av CLR, är registreringen effektivt för själva återanropsfunktionen. Värden anropar OnMemoryNotification för att rapportera minnestrycksförhållanden i stället för att använda win32-standardfunktionen CreateMemoryResourceNotification . Mer information finns i Windows Platform-dokumentationen.

Anteckning

Anrop för att OnMemoryNotification aldrig blockera. De återvänder alltid omedelbart.

Krav

Plattformar: Se Systemkrav.

Huvudet: MSCorEE.h

Bibliotek: Ingår som en resurs i MSCorEE.dll

.NET Framework versioner: Tillgänglig sedan 2.0

Se även

  • Last updated on