호스트에서 보고한 대로 현재 사용 중이기 때문에 사용할 수 없는 실제 메모리 양을 가져옵니다.
HRESULT GetMemoryLoad (
[out] DWORD* pMemoryLoad,
[out] SIZE_T *pAvailableBytes
);
매개 변수
pMemoryLoad
[out] 현재 사용 중인 총 실제 메모리의 대략적인 비율에 대한 포인터입니다.pAvailableBytes
[out] CLR(공용 언어 런타임)에서 사용할 수 있는 바이트 수에 대한 포인터입니다.
반환 값
HRESULT |
설명 |
|---|---|
S_OK |
GetMemoryLoad에서 성공적으로 반환되었습니다. |
HOST_E_CLRNOTAVAILABLE |
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 필드 값과 같습니다.
런타임에서 이 반환 값은 가비지 수집기에 휴리스틱으로 사용됩니다. 예를 들어, 메모리가 대부분 사용 중인 것으로 보고되면 가비지 수집기는 사용 가능한 상태가 될 수 있는 메모리 양을 늘리기 위해 가비지 수집을 여러 번 수행하는 경우도 있습니다.
요구 사항
플랫폼: .NET Framework 시스템 요구 사항 참조
헤더: MSCorEE.h
라이브러리: MSCorEE.dll에 리소스로 포함됨
.NET Framework 버전: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0