TdhAggregatePayloadFilters 함수(tdh.h)

TdhAggregatePayloadFilters 함수는 EnableTraceEx2 함수에 사용하기 위해 단일 공급자에 대한 여러 페이로드 필터를 단일 데이터 구조로 집계합니다.

구문

TDHSTATUS TdhAggregatePayloadFilters(
                 ULONG                    PayloadFilterCount,
                 PVOID                    *PayloadFilterPtrs,
  [in, optional] PBOOLEAN                 EventMatchALLFlags,
  [out]          PEVENT_FILTER_DESCRIPTOR EventFilterDescriptor
);

매개 변수

PayloadFilterCount

페이로드 필터의 수입니다.

PayloadFilterPtrs

TdhCreatePayloadFilter 함수를 호출하여 만든 이벤트 페이로드 단일 필터의 배열입니다.

[in, optional] EventMatchALLFlags

PayloadFilterPtrs 매개 변수에 전달된 각 페이로드 필터에 해당하며 여러 조건이 지정될 때 이벤트가 처리되는 방식을 나타내는 부울 값의 배열입니다. 이 매개 변수는 동일한 이벤트에 대해 여러 페이로드 필터를 지정하는 상황에만 영향을 줍니다.

부울 값이 TRUE이면 필터에 지정된 조건이 TRUE인 경우 이벤트가 세션에 기록됩니다. 동일한 이벤트 ID 또는 이벤트 버전에 대해 하나 이상의 필터에서 이 플래그가 TRUE 로 설정된 경우 이벤트에 대한 플래그가 지정된 모든 필터가 충족되는 경우에만 이벤트가 기록됩니다.

부울 값이 FALSE이면 필터에 지정된 모든 조건이 TRUE인 경우에만 이벤트가 세션에 기록됩니다. 동일한 이벤트 ID 또는 이벤트 버전에 대해 하나 이상의 필터에서 이 플래그가 FALSE 로 설정된 경우 플래그가 지정되지 않은 필터가 충족되면 이벤트가 기록됩니다.

[out] EventFilterDescriptor

EnableTraceEx2 함수와 함께 사용할 EVENT_FILTER_DESCRIPTOR 구조체에 대한 포인터입니다. EVENT_FILTER_DESCRIPTOR 구조에는 이 함수에 의해 할당된 집계된 페이로드 필터에 대한 포인터가 포함됩니다.

EnableTraceEx2 함수와 함께 이 EVENT_FILTER_DESCRIPTOR 구조체를 사용하여 호출자가 완료되면 할당된 메모리를 해제하려면 TdhCleanupPayloadEventFilterDescriptor 함수를 호출해야 합니다.

반환 값

성공하면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 이 함수는 다른 코드 외에도 다음 반환 코드 중 하나를 반환합니다.

반환 코드 설명
ERROR_INVALID_PARAMETER
하나 이상의 매개 변수가 잘못되었습니다.
ERROR_NOT_ENOUGH_MEMORY
집계된 페이로드 필터를 만들기 위해 메모리를 할당할 수 없습니다.

설명

Windows 8.1,Windows Server 2012 R2 이상에서는 EnableTraceEx2 함수에서 이벤트 페이로드 필터를 사용하여 로거 세션에서 이벤트의 특정 콘텐츠를 필터링할 수 있습니다.

TdhAggregatePayloadFilters 함수는 단일 공급자에 대한 페이로드 필터를 EnableTraceEx2 함수에 사용할 단일 데이터 구조로 집계합니다. TdhAggregatePayloadFilters는 집계된 페이로드 필터에 대해 불투명 데이터 구조를 할당하고 채웁니다. 집계된 페이로드 필터가 더 이상 필요하지 않으면 TdhCleanupPayloadEventFilterDescriptor 함수를 사용하여 반환된 EVENT_FILTER_DESCRIPTOR 구조에서 집계된 페이로드 필터에 할당된 메모리를 해제합니다.

예제

TdhAggregatePayloadFilters 함수를 사용하여 로거 세션의 특정 조건을 필터링하는 데 사용할 페이로드 필터를 집계하는 예제는 EnableTraceEx2 함수의 예제를 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 8.1 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 tdh.h
라이브러리 Tdh.lib
DLL Tdh.dll

추가 정보

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTraceEx2

TdhCleanupPayloadEventFilterDescriptor

TdhCreatePayloadFilter

TdhDeletePayloadFilter