posix_trace_eventset_empty 子例程

用途

清空跟踪事件类型集。

库

Posix 跟踪库 (libposixtrace.a)

语法

#include <trace.h>

int posix_trace_eventset_empty(set)
trace_event_set_t *set;

描述

此子例程处理跟踪事件类型的集合。 它对应用程序可寻址的数据对象执行操作，而不是对任何跟踪流的当前跟踪事件过滤器执行操作。

posix_trace_eventset_empty子程序将初始化由set参数指向的跟踪事件类型集，从而将所有已定义的跟踪事件类型（包括系统和用户）排除在该集之外。

应用程序在进一步使用跟踪_event_set_t类型的每个对象之前，至少要为该对象调用一次 "posix_trace_eventset_empty或 "posix_trace_eventset_fill子程序。 If an object is not initialized in this way, but is supplied as a parameter to any of the posix_trace_eventset_add, posix_trace_eventset_del, or posix_trace_eventset_ismember subroutines, the results are not defined.

参数

返回值

成功完成后，此子例程将返回值 0。 否则，将返回相应的错误号。

错误

文件

文件参考中的trace.h文件。