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