ICorProfilerInfo3 인터페이스
코드 프로파일러가 이벤트 모니터링을 제어하고 정보를 요청하기 위해 CLR(공용 언어 런타임)과 통신할 때 사용하는 메서드를 제공합니다. ICorProfilerInfo3 인터페이스는 ICorProfilerInfo2 인터페이스를 확장한 것입니다. 이 인터페이스는 .NET Framework 버전 4 및 이후 버전에서 지원되는 새로운 메서드를 제공합니다.
메서드
메서드 |
설명 |
|---|---|
이전에 JIT로 컴파일된 모든 함수에 대한 열거자를 반환합니다. |
|
응용 프로그램에 로드된 관리되는 모듈의 컬렉션을 순차적으로 반복하는 메서드를 제공하는 열거자를 반환합니다. |
|
지정된 모듈이 로드된 응용 프로그램 도메인의 식별자를 가져옵니다. |
|
FunctionEnter3WithInfo 함수에 의해 프로파일러에 보고되는 함수의 스택 프레임 및 인수 정보를 제공합니다. FunctionEnter3WithInfo 콜백 중에만 호출할 수 있습니다. |
|
FunctionLeave3WithInfo function 함수에 의해 프로파일러에 보고되는 함수의 스택 프레임 및 반환 값을 제공합니다. FunctionLeave3WithInfo 콜백 중에만 호출할 수 있습니다. |
|
FunctionTailcall3WithInfo 함수에 의해 프로파일러에 보고되는 함수의 스택 프레임을 제공합니다. FunctionTailcall3WithInfo 콜백 중에만 호출할 수 있습니다. |
|
모듈 ID가 제공된 경우 모듈의 파일 이름, 모듈의 부모 어셈블리 ID 및 모듈의 속성을 설명하는 비트 마스크를 반환합니다. |
|
프로파일링되고 있는 런타임에 대한 버전 정보를 제공합니다. |
|
문자열 개체의 레이아웃에 대한 정보를 가져옵니다. |
|
지정된 스레드 및 응용 프로그램 도메인의 범위에 있는 특정 스레드에 정적인 필드의 주소를 가져옵니다. |
|
런타임에 프로파일러를 분리하도록 지시합니다. |
|
FunctionEnter3, FunctionLeave3 및 FunctionTailcall3 함수에서 호출될 프로파일러 구현 함수를 지정합니다. |
|
관리되는 함수의 FunctionEnter3WithInfo, FunctionLeave3WithInfo 및 FunctionTailcall3WithInfo 후크에서 호출될 프로파일러 구현 함수를 지정합니다. |
|
FunctionID 값을 프로파일러의 함수 시작/종료 후크에 전달된 대체 값으로 매핑하기 위해 호출할 프로파일러 구현 함수를 지정합니다. 이 메서드는 프로파일러가 런타임 중에 모호함을 없애기 위해 사용할 수 있는 매개 변수로 ICorProfilerInfo::SetFunctionIDMapper를 확장합니다 |
설명
CLR에서는 자유 스레드 모델을 사용하여 ICorProfilerInfo3 인터페이스의 메서드를 구현합니다. 각 메서드는 성공 또는 실패를 나타내는 HRESULT를 반환합니다. 가능한 반환 코드의 목록을 보려면 CorError.h 파일을 참조하십시오.
CLR에서는 초기화하는 동안 ICorProfilerCallback::Initialize 또는 ICorProfilerCallback3::InitializeForAttach 메서드의 프로파일러 구현을 사용하여 각 코드 프로파일러에 ICorProfilerInfo3 인터페이스를 전달합니다. 그런 다음 코드 프로파일러에서는 ICorProfilerInfo3 메서드를 호출하여 CLR의 제어에 따라 실행되는 관리 코드에 대한 정보를 얻을 수 있습니다.
AppDomainID 및 FunctionID 값에 대한 자세한 내용은 프로파일링 및 런타임 알림 ID를 참조하십시오.
요구 사항
플랫폼: .NET Framework 시스템 요구 사항 참조
헤더: CorProf.idl, CorProf.h
라이브러리: CorGuids.lib
.NET Framework 버전: 4