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 함수의 예제를 참조하세요.