TdhCleanupPayloadEventFilterDescriptor 函数 (tdh.h)

TdhCleanupPayloadEventFilterDescriptor 函数释放使用 TdhAggregatePayloadFilters 函数创建的有效负载筛选器的聚合结构。

语法

TDHSTATUS TdhCleanupPayloadEventFilterDescriptor(
  [in, out] PEVENT_FILTER_DESCRIPTOR EventFilterDescriptor
);

[in, out] EventFilterDescriptor

指向 EVENT_FILTER_DESCRIPTOR 结构的指针，该结构包含要释放分配的内存的聚合筛选器。传递 的 EVENT_FILTER_DESCRIPTOR 结构是通过调用 TdhAggregatePayloadFilters 函数创建的。

如果调用成功，则会为聚合筛选器释放分配的内存，并重新初始化返回的 EVENT_FILTER_DESCRIPTOR 结构中的字段

如果成功，则返回ERROR_SUCCESS。否则，除了其他返回代码之外，此函数还返回以下返回代码之一。

返回代码	说明
ERROR_INVALID_PARAMETER	一个或多个参数无效。

在 Windows 8.1、Windows Server 2012 R2 及更高版本中，EnableTraceEx2 函数可以使用事件有效负载筛选器来筛选记录器会话中事件的特定内容。

TdhCleanupPayloadEventFilterDescriptor 函数用于释放由 TdhAggregatePayloadFilters 函数返回的分配的内存。

有关使用 TdhCleanupPayloadEventFilterDescriptor 函数释放聚合有效负载筛选器使用的内存的示例，请参阅 EnableTraceEx2 函数的示例。