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 函式的範例。