IHostMemoryManager::GetMemoryLoad 메서드

호스트에서 보고한 대로 현재 사용 중이어서 사용할 수 없는 실제 메모리의 양을 가져옵니다.

구문

HRESULT GetMemoryLoad (  
    [out] DWORD*  pMemoryLoad,
    [out] SIZE_T  *pAvailableBytes  
);

pMemoryLoad
[out] 현재 사용 중인 총 실제 메모리의 대략적인 백분율에 대한 포인터입니다.

pAvailableBytes
[out] CLR(공용 언어 런타임)에 사용할 수 있는 바이트 수에 대한 포인터입니다.

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

GetMemoryLoad는 Win32 GlobalMemoryStatus 함수를 래핑합니다. pMemoryLoad의 값은 GlobalMemoryStatus에서 반환된 MEMORYSTATUS 구조체의 dwMemoryLoad 필드와 동일합니다.

런타임은 반환 값을 가비지 수집기에 대한 휴리스틱으로 사용합니다. 예를 들어 호스트가 대부분의 메모리가 사용 중이라고 보고하는 경우 가비지 수집기는 잠재적으로 사용할 수 있는 메모리 양을 늘리기 위해 여러 세대에서 수집하도록 선택할 수 있습니다.

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

헤더: MSCorEE.h

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

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