共用方式為


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。 否則,此函式除了傳回其他傳回碼之外,還會傳回下列其中一個傳回碼。

傳回碼 Description
ERROR_INVALID_PARAMETER
一或多個參數無效。

備註

在 Windows 8.1、Windows Server 2012 R2 和更新版本上,EnableTraceEx2 函式可以使用事件承載篩選,以篩選記錄器會話中事件的特定內容。

TdhCleanupPayloadEventFilterDescriptor 函式可用來釋放 TdhAggregatePayloadFilters 函式所傳回的記憶體。

範例

如需使用 TdhCleanupPayloadEventFilterDescriptor 函式來釋放匯總承載篩選所使用的記憶體的範例,請參閱 EnableTraceEx2 函式的範例。

規格需求

需求
最低支援的用戶端 Windows 8.1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 tdh.h
程式庫 Tdh.lib
Dll Tdh.dll

另請參閱

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTraceEx2

TdhAggregatePayloadFilters

TdhCreatePayloadFilter

TdhDeletePayloadFilter