pm_clear_ebb_handler Subroutine
Zweck
Löscht die für den aufrufenden Thread konfigurierte EBB-Funktion (Event-Based Branching, ereignisbasierte Verzweigung).
Bibliothek
Performance Monitor APIs Library (libpmapi.a)
Syntax
#include <pmapi.h>
int pm_clear_ebb_handler (void ** old_handler, void ** old_data_area)
Beschreibung
Die Subroutine pm_clear_ebb_handler löscht die EBB-Funktion, die zuvor für den aufrufenden Thread konfiguriert wurde, über die Subroutine pm_set_ebb_handler .
Hinweis: Die Subroutine pm_clear_ebb_handler kann nur aufgerufen werden, wenn der Threadmodus 1: 1 ist und die Zählung für den Thread nicht gestartet wurde.
Parameter
| Element | Beschreibung |
|---|---|
| old_handler | Der alte EBB-Handler, der für den Thread konfiguriert ist Der Wert kann auf NULL gesetzt werden, wenn er nicht erforderlich ist. |
| alte_datenbereich | Der alte EBB-Datenbereich. Der Wert kann auf NULL gesetzt werden, wenn er nicht erforderlich ist. |
Rückgabewerte
Ist dies nicht erfolgreich, wird ein anderer Wert als null zurückgegeben und ein positiver Fehlercode festgelegt. Bei erfolgreicher Ausführung wird der Wert null zurückgegeben.
Fehlercodes
Die Subroutine ist nicht erfolgreich, wenn einer der folgenden Fehlercodes zurückgegeben wird:
| Element | Beschreibung |
|---|---|
| Pmapi_NoInit | Die Subroutine pm_initialize wird nicht aufgerufen. |
| Pmapi_Unsupported_EBBThreadMode | Der Thread wird nicht im 1:1-Modus ausgeführt. |
| Pmapi_NoSetProg | Die Subroutine pm_set_program wird nicht aufgerufen. |
| Pmapi_Invalid_EBB_Config | Das Flag PTHREAD_EBB_PMU_TYPE wird nicht an die Subroutine pthread übergeben. |
| Pmapi_EBB_NotSet | Der EBB-Handler wird vom Aufrufenden nicht festgelegt. |
| Fehlercodes ungleich null | Wird vom Aufruf pthread oder pmsvcs zurückgegeben. |
Dateien
Die Datei pmapi.h definiert Standardmakros, Datentypen und Subroutinen.