IHostMemoryManager::RegisterMemoryNotificationCallback 메서드

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

HRESULT RegisterMemoryNotificationCallback (
    [in] ICLRMemoryNotificationCallback* pCallback
);

매개 변수

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

반환 값

HRESULT	설명
S_OK	RegisterMemoryNotificationCallback에서 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE	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 플랫폼 설명서를 참조하십시오.