프로파일링 전역 정적 함수

아티클
05/10/2023

이 섹션에서는 프로파일링 API에서 사용하는 관리되지 않는 API 함수에 대해 설명합니다.

섹션 내용

.NET Framework 버전 1 프로파일링 함수

FunctionEnter 함수
컨트롤이 함수에 전달되고 있음을 프로파일러에 알립니다. .NET Framework 2.0에서 더 이상 사용되지 않습니다.

FunctionLeave 함수
함수가 호출자에게 반환하려고 함을 프로파일러에 알립니다. .NET Framework 2.0에서 더 이상 사용되지 않습니다.

FunctionTailcall 함수
현재 실행 중인 함수가 다른 함수에 대한 마무리 호출을 수행하려고 한다는 것을 프로파일러에 알립니다. .NET Framework 2.0에서 더 이상 사용되지 않습니다.

.NET Framework 버전 2 프로파일링 함수

FunctionIDMapper 함수
지정된 함수 식별자를 해당 함수에 대한 FunctionEnter2, FunctionLeave2 및 FunctionTailcall2 콜백에서 사용할 대체 ID에 다시 매핑할 수 있음을 프로파일러에 알립니다. 프로파일러는 해당 함수에 대한 콜백을 받을지 여부를 나타낼 수도 있습니다.

FunctionEnter2 함수
컨트롤이 함수에 전달되고 있음을 프로파일러에 알리고 스택 프레임 및 함수 인수에 대한 정보를 제공합니다. .NET Framework 4에서 더 이상 사용되지 않습니다.

FunctionLeave2 함수
함수가 호출자에게 곧 반환될 것임을 프로파일러에 알리고 스택 프레임 및 함수 반환 값에 대한 정보를 제공합니다. .NET Framework 4에서 더 이상 사용되지 않습니다.

FunctionTailcall2 함수
현재 실행 중인 함수가 다른 함수에 대한 마무리 호출을 수행하려고 했음을 프로파일러에 알리고 스택 프레임에 대한 정보를 제공합니다. .NET Framework 4에서 더 이상 사용되지 않습니다.

StackSnapshotCallback 함수
ICorProfilerInfo2::DoStackSnapshot 메서드에 의해 시작되는 스택 워크 동안 스택에서 각 관리 프레임 및 각 비관리 프레임 실행에 대한 정보를 프로파일러에 제공합니다.

.NET Framework 버전 4 프로파일링 함수

FunctionIDMapper2 함수
지정된 함수 식별자를 해당 함수에 대한 FunctionEnter3, FunctionLeave3 및 FunctionTailcall3 또는 FunctionEnter3WithInfo, FunctionLeave3WithInfo 및 FunctionTailcall3WithInfo 콜백에서 사용할 대체 ID에 다시 매핑할 수 있음을 프로파일러에 알립니다. 프로파일러는 해당 함수에 대한 콜백을 받을지 여부를 나타낼 수도 있습니다.

FunctionIDMapper2는 clientData 매개 변수를 사용하여 FunctionIDMapper 함수를 확장합니다. 이 매개 변수는 프로파일러가 런타임 간에 명확하게 구분하는 데 사용할 수 있습니다.

FunctionEnter3 함수
컨트롤이 함수에 전달되고 있음을 프로파일러에 알립니다.

FunctionEnter3WithInfo 함수
컨트롤이 함수에 전달되고 있음을 프로파일러에 알리고 스택 프레임 및 함수 인수를 검색하기 위해 ICorProfilerInfo3::GetFunctionEnter3Info에 전달될 수 있는 핸들을 제공합니다.

FunctionLeave3 함수
함수에서 컨트롤이 반환되고 있음을 프로파일러에 알릴 수 있습니다.

FunctionLeave3WithInfo 함수
함수에서 반환되는 컨트롤을 프로파일러에 알리고, 스택 프레임 및 반환 값을 검색하기 위해 ICorProfilerInfo3::GetFunctionLeave3Info에 전달할 수 있는 핸들을 제공합니다.

FunctionTailcall3 함수
현재 실행 중인 함수가 다른 함수에 대한 마무리 호출을 수행하려고 한다는 것을 프로파일러에 알립니다.

FunctionTailcall3WithInfo 함수
현재 실행 중인 함수가 다른 함수에 대해 마무리 호출을 수행하려고 한다는 것을 프로파일러에 알리고 스택 프레임을 검색하기 위해 ICorProfilerInfo3::GetFunctionTailcall3Info에 전달할 수 있는 핸들을 제공합니다.