pm_clear_ebb_handler 서브루틴

용도

호출 스레드에 대해 구성된 이벤트 기반 분기 (EBB) 기능을 지웁니다.

라이브러리

성능 모니터 API 라이브러리 (libpmapi.a)

구문

#include <pmapi.h>
int pm_clear_ebb_handler (void ** old_handler, void ** old_data_area)

설명

pm_clear_ebb_handler 서브루틴은 pm_set_ebb_handler 서브루틴을 통해 호출 스레드에 대해 이전에 구성된 EBB 기능을 지웁니다.

주: pm_clear_ebb_handler 서브루틴은 스레드 모드가 1: 1이고 스레드에 대한 계수가 시작되지 않은 경우에만 호출할 수 있습니다.

매개변수

항목 설명
old_handler 스레드에 대해 구성된 이전 EBB 핸들러입니다. 필요하지 않은 경우 값을 NULL로 설정할 수 있습니다.
old_data_area 이전 EBB 데이터 영역입니다. 필요하지 않은 경우 값을 NULL로 설정할 수 있습니다.

리턴 값

실패하면 0이외의 값이 리턴되고 양수 오류 코드가 설정됩니다. 성공하면 0값이 리턴됩니다.

오류 코드

다음 오류 코드 중 하나가 리턴되면 서브루틴이 실패합니다.

항목 설명
Pmapi_NoInit pm_initialize 서브루틴은 호출되지 않습니다.
Pmapi_Unsupported_EBBThreadMode 스레드가 1: 1모드에서 실행되고 있지 않습니다.
Pmapi_NoSetProg pm_set_program 서브루틴이 호출되지 않습니다.
Pmapi_Invalid_EBB_Config PTHREAD_EBB_PMU_TYPE 플래그는 pthread 서브루틴으로 전달되지 않습니다.
Pmapi_EBB_NotSet 호출자가 EBB 핸들러를 설정하지 않았습니다.
0이 아닌 오류 코드 pthread 호출 또는 pmsvcs 호출에 의해 리턴됩니다.

파일

pmapi.h 파일은 표준 매크로, 데이터 유형 및 서브루틴을 정의합니다.