ICorProfilerInfo3 인터페이스

  • 아티클

코드 프로파일러가 이벤트 모니터링을 제어하고 정보를 요청하기 위해 CLR(공용 언어 런타임)과 통신하는 데 사용하는 메서드를 제공합니다. ICorProfilerInfo3 인터페이스는 ICorProfilerInfo2 인터페이스의 확장입니다. .NET Framework 4 이상 버전에서 지원되는 새 메서드를 제공합니다.

메서드

메서드 Description
EnumJITedFunctions 메서드 이전에 JIT 컴파일된 모든 함수에 대해 열거자를 반환합니다.
EnumModules 메서드 애플리케이션에 로드되는 관리 모듈 컬렉션을 순차적으로 반복하는 메서드를 제공하는 열거자를 반환합니다.
GetAppDomainsContainingModule 메서드 지정된 모듈이 로드된 애플리케이션 도메인의 식별자를 가져옵니다.
GetFunctionEnter3Info 메서드 FunctionEnter3WithInfo 함수가 프로파일러에 보고하는 함수의 스택 프레임 및 인수 정보를 제공하며, FunctionEnter3WithInfo 콜백 중에만 호출할 수 있습니다.
GetFunctionLeave3Info 메서드 FunctionLeave3WithInfo function 함수가 프로파일러에 보고하는 함수의 스택 프레임 및 반환 값을 제공하며, FunctionLeave3WithInfo 콜백 중에만 호출할 수 있습니다.
GetFunctionTailcall3Info 메서드 FunctionTailcall3WithInfo 함수가 프로파일러에 보고하는 함수의 스택 프레임을 제공하며, FunctionTailcall3WithInfo 콜백 중에만 호출할 수 있습니다.
GetModuleInfo2 메서드 모듈 ID가 지정된 경우 모듈의 파일 이름, 모듈의 부모 어셈블리 ID 및 모듈 속성을 설명하는 비트 마스크를 반환합니다.
GetRuntimeInformation 메서드 프로파일링되는 런타임에 대한 버전 정보를 제공합니다.
GetStringLayout2 메서드 문자열 개체의 레이아웃 정보를 가져옵니다.
GetThreadStaticAddress2 메서드 지정된 스레드 및 애플리케이션 도메인의 범위에 있는 지정된 Thread 정적 필드의 주소를 가져옵니다.
RequestProfilerDetach 메서드 런타임에 프로파일러를 분리하도록 지시합니다.
SetEnterLeaveFunctionHooks3 메서드 FunctionEnter3, FunctionLeave3, FunctionTailcall3 함수에서 호출되는 프로파일러 구현 함수를 지정합니다.
SetEnterLeaveFunctionHooks3WithInfo 메서드 관리되는 함수의 FunctionEnter3WithInfo, FunctionLeave3WithInfo 및 FunctionTailcall3WithInfo 후크에서 호출되는 프로파일러 구현 함수를 지정합니다.
SetFunctionIDMapper2 메서드 FunctionID 값을 대체 값에 매핑하기 위해 호출되는 프로파일러 구현 함수를 지정합니다. 대체 값은 프로파일러의 함수 진입점/종료점 후크에 전달됩니다. 이 메서드는 프로파일러가 런타임을 구분하는 데 사용할 수 있는 매개 변수로 ICorProfilerInfo::SetFunctionIDMapper를 확장합니다.

설명

CLR은 자유 스레드 모델을 사용하여 ICorProfilerInfo3 인터페이스의 메서드를 구현합니다. 각 메서드가 HRESULT를 반환하여 성공 또는 실패를 나타냅니다. 가능한 반환 코드 목록은 CorError.h 파일을 참조하세요.

CLR은 프로파일러의 ICorProfilerCallback::Initialize 또는 ICorProfilerCallback3::InitializeForAttach 메서드 구현을 사용하여 초기화 중 각 코드 프로파일러에 ICorProfilerInfo3 인터페이스를 전달합니다. 그런 다음 코드 프로파일러가 ICorProfilerInfo3 메서드를 호출하여 CLR의 제어에 따라 실행되는 관리 코드에 대한 정보를 가져올 수 있습니다.

요구 사항

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

헤더: CorProf.idl, CorProf.h

라이브러리: CorGuids.lib

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

참고 항목