ICorDebugProcess6::EnableVirtualModuleSplitting 메서드

  • 아티클

가상 모듈 분할을 사용하거나 사용하지 않도록 설정합니다.

구문

HRESULT EnableVirtualModuleSplitting(  
   BOOL enableSplitting  
);

매개 변수

enableSplitting
가상 모듈 분할을 사용하려면 true로 설정하고, 사용하지 않으려면 false로 설정합니다.

설명

가상 모듈 분할을 사용하는 경우 ICorDebug가 빌드 프로세스 중에 병합된 모듈을 인식하여 대형 모듈 하나가 아닌 개별 모듈의 그룹으로 표시합니다. 이 경우 아래에서 설명하는 여러 ICorDebug 메서드의 동작이 변경됩니다.

참고

이 메서드는 .NET 네이티브에서만 사용할 수 있습니다.

언제든지 이 메서드를 호출하여 enableSplitting의 값을 변경할 수 있습니다. 이렇게 해도 메서드 호출 시 가상 모듈 분할 및 관리되지 않는 디버깅 API 섹션에 나와 있는 메서드 동작이 변경되는 것을 제외하면 ICorDebug 개체의 상태 저장 기능은 변경되지 않습니다. 가상 모듈을 사용하는 경우 해당 메서드를 호출할 때 성능이 저하됩니다. 또한 IMetaDataImport API를 올바르게 구현하려면 많은 양의 가상화된 메타데이터를 메모리 내에서 캐시해야 할 수 있으며, 가상 모듈 분할을 해제한 후에도 이러한 캐시가 보존될 수 있습니다.

용어

아래에는 가상 모듈 분할을 설명하는 데 사용되는 용어가 나와 있습니다.

컨테이너 모듈/컨테이너
집계 모듈입니다.

하위 모듈/가상 모듈
컨테이너에 있는 모듈입니다.

일반 모듈
빌드 시에 병합되지 않은 모듈로, 컨테이너 모듈도 아니고 하위 모듈도 아닌 모듈입니다.

컨테이너 모듈과 하위 모듈은 ICorDebugModule 인터페이스 개체로 표시됩니다. 그러나 각 인터페이스의 동작은 약간씩 다르며 이러한 동작에 대한 설명은 <섹션에 대한 상호 참조> 섹션에 있습니다.

모듈 및 어셈블리

다중 모듈 어셈블리는 어셈블리 병합 시나리오에서 지원되지 않으므로 모듈과 어셈블리 간에는 일 대 일 관계가 적용됩니다. 각 ICorDebugModule 개체는 표시하는 모듈(컨테이너 모듈 또는 하위 모듈)에 관계없이 해당하는 ICorDebugAssembly 개체를 포함합니다. ICorDebugModule::GetAssembly 메서드는 모듈을 어셈블리로 변환합니다. 반대 방향으로 매핑하려는 경우 ICorDebugAssembly::EnumerateModules 메서드는 모듈을 하나만 열거합니다. 이 경우 어셈블리와 모듈은 긴밀하게 결합된 쌍을 형성하므로 '어셈블리'와 '모듈'이라는 용어는 거의 동일한 의미로 사용됩니다.

동작의 차이

컨테이너 모듈의 동작 및 특성은 다음과 같습니다.

  • 컨테이너 모듈을 구성하는 모든 하위 모듈의 메타데이터는 병합됩니다.

  • 형식 이름이 변환될 수 있습니다.

  • ICorDebugModule::GetName 메서드는 디스크의 모듈 경로를 반환합니다.

  • ICorDebugModule::GetSize 메서드는 해당 이미지의 크기를 반환 합니다.

  • ICorDebugAssembly3.EnumerateContainedAssemblies 메서드는 하위 모듈을 나열합니다.

  • ICorDebugAssembly3.GetContainerAssembly 메서드는 S_FALSE를 반환합니다.

하위 모듈의 동작 및 특성은 다음과 같습니다.

  • 병합된 원래 어셈블리에 해당하는 축소된 메타데이터 집합을 포함합니다.

  • 메타데이터 이름이 변환되지 않습니다.

  • 메타데이터 토큰이 빌드 프로세스에서 병합되기 전의 원래 어셈블리에 포함되어 있던 토큰과 일치할 가능성은 거의 없습니다.

  • ICorDebugModule::GetName 메서드는 파일 경로가 아닌 어셈블리 이름을 반환합니다.

  • ICorDebugModule::GetSize 메서드는 병합되지 않은 원래 이미지 크기를 반환합니다.

  • ICorDebugModule3.EnumerateContainedAssemblies 메서드는 S_FALSE를 반환합니다.

  • ICorDebugAssembly3.GetContainerAssembly 메서드는 포함하는 모듈을 반환합니다.

모듈에서 검색되는 인터페이스

다양한 인터페이스를 만들거나 모듈에서 검색할 수 있습니다. 그 중 일부는 다음과 같습니다.

이러한 개체는 항상 ICorDebug에 의해 캐시되며, 작성되거나 쿼리된 모듈(컨테이너 모듈 또는 하위 모듈)에 관계없이 같은 포인터 ID를 포함합니다. 하위 모듈은 이와 같은 캐시된 개체의 필터링된 보기를 제공하며 자체 복사본이 포함된 별도의 캐시를 제공하지는 않습니다.

가상 모듈 분할 및 관리되지 않는 디버깅 API

다음 표에서는 가상 모듈 분할이 관리되지 않는 디버깅 API의 다른 메서드 동작에 주는 영향을 설명합니다.

방법 enableSplitting = true enableSplitting = false
ICorDebugFunction::GetModule 이 함수가 원래 정의된 하위 모듈을 반환합니다. 이 함수가 병합된 컨테이너 모듈을 반환합니다.
ICorDebugClass::GetModule 이 클래스가 원래 정의된 하위 모듈을 반환합니다. 이 클래스가 병합된 컨테이너 모듈을 반환합니다.
ICorDebugModuleDebugEvent::GetModule 로드된 컨테이너 모듈을 반환합니다. 이 설정에 관계없이 하위 모듈에는 로드 이벤트가 제공되지 않습니다. 로드된 컨테이너 모듈을 반환합니다.
ICorDebugAppDomain::EnumerateAssemblies 하위 어셈블리와 일반 어셈블리 목록을 반환합니다. 컨테이너 어셈블리는 포함되지 않습니다. 참고: 컨테이너 어셈블리에 기호가 없으면 해당 하위 어셈블리가 열거되지 않습니다. 일반 어셈블리의 경우 기호가 없으면 열거될 수도 있고 열거되지 않을 수도 있습니다. 컨테이너 어셈블리와 일반 어셈블리 목록을 반환합니다. 하위 어셈블리는 포함되지 않습니다. 참고: 일반 어셈블리의 경우 기호가 없으면 열거될 수도 있고 열거되지 않을 수도 있습니다.
ICorDebugCode::GetCode(IL 코드를 참조하는 경우만 해당됨) 병합 전 어셈블리 이미지에서 유효했던 IL을 반환합니다. 즉, 참조하는 형식이 IL을 포함하는 가상 모듈에 정의되어 있지 않으면 모든 인라인 메타데이터 토큰은 TypeRef 또는 MemberRef 토큰이 됩니다. 해당하는 가상 ICorDebugModule 개체의 IMetaDataImport 개체에서 이러한 TypeRef 또는 MemberRef 토큰을 조회할 수 있습니다. 병합 후 어셈블리 이미지의 IL을 반환합니다.

요구 사항

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

헤더: CorDebug.idl, CorDebug.h

라이브러리: CorGuids.lib

.NET Framework 버전: 4.6부터 사용 가능, .NET 네이티브만 해당

참고 항목