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 파일은 표준 매크로, 데이터 유형 및 서브루틴을 정의합니다.