IHostMemoryManager::RegisterMemoryNotificationCallback 메서드

호스트가 호출하는 콜백 함수에 대한 포인터를 등록하여 컴퓨터의 현재 메모리 로드를 CLR(공용 언어 런타임)에 알립니다.

구문

HRESULT RegisterMemoryNotificationCallback (  
    [in] ICLRMemoryNotificationCallback* pCallback  
);  

매개 변수

pCallback
[in] CLR에 의해 구현되는 ICLRMemoryNotificationCallback 인스턴스에 대한 인터페이스 포인터입니다.

Return Value

HRESULT	설명
S_OK	RegisterMemoryNotificationCallback가 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE	CLR이 프로세스에 로드되지 않았거나 CLR이 관리 코드를 실행하거나 호출을 성공적으로 처리할 수 없는 상태입니다.
HOST_E_TIMEOUT	호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER	호출자는 잠금을 소유하지 않습니다.
HOST_E_ABANDONED	차단된 스레드 또는 파이버가 이벤트를 기다리는 동안 이벤트가 취소되었습니다.
E_FAIL	알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환하면 CLR은 더 이상 프로세스 내에서 사용할 수 없습니다. 호스팅 메서드에 대한 후속 호출은 HOST_E_CLRNOTAVAILABLE을 반환합니다.

설명

ICLRMemoryNotificationCallback 인터페이스는 하나의 메서드(ICLRMemoryNotificationCallback::OnMemoryNotification)만 정의하고 pCallback은 CLR에서 제공하는 ICLRMemoryNotificationCallback 인스턴스에 대한 포인터이므로 등록은 콜백 함수 자체를 위한 것입니다. 호스트는 표준 Win32 CreateMemoryResourceNotification 함수를 사용하는 대신 OnMemoryNotification을 호출하여 메모리 압력 조건을 보고합니다. 자세한 내용은 Windows 플랫폼 설명서를 참조하세요.

참고

OnMemoryNotification에 대한 호출은 차단되지 않습니다. 항상 즉시 반환합니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: MSCorEE.h

라이브러리: 리소스로 MSCorEE.dll에 포함됩니다.

.NET Framework 버전: 2.0부터 사용 가능

참고 항목

• ICLRMemoryNotificationCallback 인터페이스
• IHostMemoryManager 인터페이스