다음을 통해 공유


PartyManager::SetProfilingCallbacksForMethodEntryExit

선택적으로 계측된 메서드를 입력하거나 종료할 때 파티 라이브러리가 만들 프로파일링 이벤트 콜백을 구성합니다.

구문

PartyError SetProfilingCallbacksForMethodEntryExit(  
    PartyProfilingMethodEntranceCallback profilingMethodEntranceCallback,  
    PartyProfilingMethodExitCallback profilingMethodExitCallback  
)  

매개 변수

profilingMethodEntranceCallback PartyProfilingMethodEntranceCallback
optional

파티 라이브러리가 프로파일링을 위해 계측된 내부 메서드에 들어갈 때 수행되는 콜백입니다.

profilingMethodExitCallback PartyProfilingMethodExitCallback
optional

파티 라이브러리가 프로파일링을 위해 계측된 내부 메서드를 종료하려고 할 때 수행되는 콜백입니다.

반환 값

PartyError

호출이 성공한 경우 c_partyErrorSuccess이고 그렇지 않은 경우 오류 코드입니다. 사용자가 읽을 수 있는 형식의 오류 코드는 GetErrorMessage()를 통해 검색할 수 있습니다.

비고

이 방법을 사용하면 타이틀이 외부 프로파일링 도구에서 파티 라이브러리 성능 메트릭을 기록하고 시각화하기 위해 사용자 지정 프로파일링 콜백 함수를 설치할 수 있습니다.

이 메서드는 Party 라이브러리가 초기화되지 않은 경우에만 호출할 수 있습니다. 파티가 초기화되는 동안 호출하면 실패하고 오류가 반환됩니다.

선택적 콜백을 nullptr로 설정하면 파티 라이브러리가 해당 이벤트 유형에 대한 프로파일링 콜백을 만들지 않습니다.

프로파일링이 타이틀 성능에 미치는 영향을 최소화하기 위해 이러한 이벤트에 대한 콜백은 초당 수백 또는 수천 번 실행될 것으로 예상되므로 가능한 한 가볍게 유지되어야 합니다.

이 메서드는 라이브러리의 Windows 및 Microsoft Game Core 버전에서만 지원됩니다. 다른 플랫폼에서 호출하는 경우 실패합니다.

요구 사항

헤더: Party.h

참고 항목

PartyManager
PartyProfilingMethodEntranceCallback
PartyProfilingMethodExitCallback
PartyManager::GetProfilingCallbacksForMethodEntryExit