Sous-routine pm_clear_ebb_handler
Objectif
Efface la fonction EBB (Event-Based Branching) configurée pour l'unité d'exécution appelante.
Bibliothèque
Bibliothèque d'API Performance Monitor (libpmapi.a)
Syntaxe
#include <pmapi.h>
int pm_clear_ebb_handler (void ** old_handler, void ** old_data_area)
Descriptif
La sous-routine pm_clear_ebb_handler efface la fonction EBB précédemment configurée pour l'unité d'exécution appelante, via la sous-routine pm_set_ebb_handler .
Remarque: La sous-routine pm_clear_ebb_handler ne peut être appelée que lorsque le mode d'unité d'exécution est 1: 1 et que le comptage pour l'unité d'exécution n'est pas démarré.
Paramètres
| Article | Descriptif |
|---|---|
| ancien_gestionnaire | Ancien gestionnaire EBB configuré pour l'unité d'exécution. La valeur peut être définie sur NULL si elle n'est pas requise. |
| ancien_zone_données | Ancienne zone de données EBB. La valeur peut être définie sur NULL si elle n'est pas requise. |
Valeurs renvoyées
En cas d'échec, une valeur différente de zéro est renvoyée et un code d'erreur positif est défini. Si l'opération aboutit, la valeur zéro est renvoyée.
Codes d'erreur
La sous-routine échoue si l'un des codes d'erreur suivants est renvoyé:
| Article | Descriptif |
|---|---|
| Pmapi_NoInit | La sous-routine pm_initialize n'est pas appelée. |
| Pmapi_Unsupported_EBBThreadMode | L'unité d'exécution ne s'exécute pas en mode 1: 1. |
| Pmapi_NoSetProg | La sous-routine pm_set_program n'est pas appelée. |
| Pmapi_Invalid_EBB_Config | L'indicateur PTHREAD_EBB_PMU_TYPE n'est pas transmis à la sous-routine pthread . |
| Pmapi_EBB_NotSet | Le gestionnaire EBB n'est pas défini par l'appelant. |
| Codes d'erreur différents de zéro | Renvoyé par l'appel pthread ou l'appel pmsvcs . |
Fichiers
Le fichier pmapi.h définit les macros standard, les types de données et les sous-routines.