Add a category with the specified name and threshold levels.
Declared in <ball_categorymanager.h>
Category*
addCategory(
char const* categoryName,
int recordLevel,
int passLevel,
int triggerLevel,
int triggerAllLevel);Add to the registry of this category manager a category having the specified categoryName, possibly changed by the registered category name filter callback, and having the specified recordLevel, passLevel, triggerLevel, and triggerAllLevel threshold values, respectively, if there is no category having (the possibly filtered) categoryName and each of the specified threshold values is in the range [0 .. 255]. Return the address of the newly-created, modifiable category on success, and 0 otherwise. The behavior is undefined unless a lock is not held by this thread on the mutex returned by rulesetMutex. Note that if a category having (the possibly filtered) categoryName already exists in the registry, 0 is returned. Note that an existing category will not be modified if a category with the (possibly filtered) categoryName already exists.
address of the newly-created category on success, and 0 otherwise
| Name | Description |
|---|---|
| categoryName | name of the category to add |
| recordLevel | record threshold level for the new category |
| passLevel | pass threshold level for the new category |
| triggerLevel | trigger threshold level for the new category |
| triggerAllLevel | trigger-all threshold level for the new category |