TdhGetEventInformation 함수(tdh.h)

이벤트에 대한 메타데이터를 검색합니다.

구문

TDHSTATUS TdhGetEventInformation(
  [in]      PEVENT_RECORD     Event,
  [in]      ULONG             TdhContextCount,
  [in]      PTDH_CONTEXT      TdhContext,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] PULONG            BufferSize
);

매개 변수

[in] Event

EventRecordCallback 콜백에 전달된 이벤트 레코드입니다. 자세한 내용은 EVENT_RECORD 구조를 참조하세요.

[in] TdhContextCount

pTdhContext의 요소 수입니다.

[in] TdhContext

WPP 또는 클래식 ETW 이벤트에 대한 컨텍스트 값의 배열입니다. 그렇지 않으면 NULL입니다. 자세한 내용은 TDH_CONTEXT 구조를 참조하세요. 배열에 중복 컨텍스트 형식이 포함되어서는 안됩니다.

[out] Buffer

이벤트 정보를 수신하기 위해 사용자가 할당한 버퍼입니다. 자세한 내용은 TRACE_EVENT_INFO 구조를 참조하세요.

[in, out] BufferSize

pBuffer 버퍼의 크기(바이트)입니다. 함수가 성공하면 이 매개 변수는 사용된 버퍼의 크기를 받습니다. 버퍼가 너무 작으면 함수는 ERROR_INSUFFICIENT_BUFFER 반환하고 이 매개 변수를 필요한 버퍼 크기로 설정합니다. 입력 시 버퍼 크기가 0이면 버퍼에 데이터가 반환되지 않으며 이 매개 변수는 필요한 버퍼 크기를 받습니다.

반환 값

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

설명

이벤트가 WPP 또는 레거시 ETW 이벤트인 경우 이벤트 정보를 구문 분석하는 데 사용되는 컨텍스트 정보를 지정할 수 있습니다. EVENT_HEADER_FLAG_TRACE_MESSAGE 플래그가 EVENT_HEADER Flags 멤버에 설정된 경우 이 이벤트는 WPP 이벤트입니다(EVENT_RECORDEventHeader 멤버 참조). EVENT_HEADER_FLAG_CLASSIC_HEADER 플래그가 설정된 경우 이벤트는 레거시 ETW 이벤트입니다.

예제

이벤트에 대한 메타데이터를 검색하는 방법을 보여 주는 예제는 TdhFormatProperty를 사용하여 이벤트 데이터 사용을 참조하세요.

요구 사항

추가 정보

TdhGetEventMapInformation

TdhGetProperty