evntrace.h 헤더

이 헤더는 여러 기술에서 사용됩니다. 자세한 내용은 다음을 참조하세요.

• 이벤트 추적
• 커널 모드 드라이버 참조

evntrace.h에는 다음과 같은 프로그래밍 인터페이스가 포함되어 있습니다.

Functions

CloseTrace CloseTrace 함수는 OpenTrace를 사용하여 만든 추적 처리 세션을 닫습니다.
ControlTraceA CONTROLTraceA(ANSI) 함수(evntrace.h)는 지정된 이벤트 추적 세션을 플러시, 쿼리, 업데이트 또는 중지합니다.
ControlTraceW ControlTraceW(유니코드) 함수(evntrace.h)는 지정된 이벤트 추적 세션을 플러시, 쿼리, 업데이트 또는 중지합니다.
CreateTraceInstanceId RegisterTraceGuids 기반("클래식") 이벤트 공급자는 CreateTraceInstanceId 함수를 사용하여 고유한 트랜잭션 식별자를 만들고 등록 핸들에 매핑합니다. 그런 다음, TraceEventInstance 함수를 호출할 때 공급자가 트랜잭션 식별자를 사용할 수 있습니다.
EnableTrace 추적 세션 컨트롤러는 EnableTrace를 호출하여 ETW 이벤트 공급자가 이벤트를 추적 세션에 기록하는 방법을 구성합니다. EnableTraceEx2 함수는 이 함수를 대체합니다.
EnableTraceEx 추적 세션 컨트롤러는 EnableTraceEx를 호출하여 ETW 이벤트 공급자가 이벤트를 추적 세션에 기록하는 방법을 구성합니다. EnableTraceEx2 함수는 이 함수를 대체합니다.
EnableTraceEx2 추적 세션 컨트롤러는 EnableTraceEx2를 호출하여 ETW 이벤트 공급자가 이벤트를 추적 세션에 기록하는 방법을 구성합니다.
EnumerateTraceGuids 현재 컴퓨터에서 실행 중인 이벤트 추적 공급자에 대한 정보를 검색합니다. EnumerateTraceGuidsEx 함수는 이 함수를 대체합니다.
EnumerateTraceGuidsEx 현재 컴퓨터에서 실행 중인 이벤트 추적 공급자에 대한 정보를 검색합니다.
FlushTraceA FLUSHTraceA(ANSI) 함수(evntrace.h)를 사용하면 이벤트 추적 세션이 지정된 세션에 대해 버퍼링된 이벤트를 즉시 전달합니다.
FlushTraceW FlushTraceW(유니코드) 함수(evntrace.h)를 사용하면 이벤트 추적 세션이 지정된 세션에 대해 버퍼링된 이벤트를 즉시 전달합니다.
GetTraceEnableFlags RegisterTraceGuids 기반("클래식") 이벤트 공급자는 GetTraceEnableFlags 함수를 사용하여 추적 컨트롤러에서 지정한 사용 플래그를 검색하여 추적할 이벤트의 범주를 나타냅니다. 공급자는 ControlCallback 함수에서 이 함수를 호출합니다.
GetTraceEnableLevel RegisterTraceGuids 기반("클래식") 이벤트 공급자는 GetTraceEnableLevel 함수를 사용하여 추적 컨트롤러에서 지정한 사용 수준을 검색하여 추적할 이벤트의 수준을 나타냅니다. 공급자는 ControlCallback 함수에서 이 함수를 호출합니다.
GetTraceLoggerHandle RegisterTraceGuids 기반("클래식") 이벤트 공급자는 GetTraceLoggerHandle 함수를 사용하여 이벤트를 작성해야 하는 이벤트 추적 세션의 핸들을 검색합니다. 공급자는 ControlCallback 함수에서 이 함수를 호출합니다.
OpenTraceA ANSI(OpenTraceA) 함수(evntrace.h)는 ETW 실시간 추적 세션 또는 ETW 로그 파일에서 이벤트를 소비하기 위한 ETW 추적 처리 핸들을 엽니다.
OpenTraceFromBufferStream 파일 또는 활성 세션에 직접 연결되지 않은 추적 처리 세션을 만듭니다.
OpenTraceFromFile Tracelog .etl 파일을 처리하는 추적 처리 세션을 만듭니다.
OpenTraceFromRealTimeLogger ETW 실시간 추적 세션 또는 ETW 로그 파일에서 이벤트를 소비하기 위한 ETW 추적 처리 핸들을 엽니다.
OpenTraceFromRealTimeLoggerWithAllocationOptions 활성 실시간 ETW 세션에 연결된 추적 처리 세션을 만듭니다.
OpenTraceW OpenTraceW(유니코드) 함수(evntrace.h)는 ETW 실시간 추적 세션 또는 ETW 로그 파일에서 이벤트를 소비하기 위한 ETW 추적 처리 핸들을 엽니다.
ProcessTrace 하나 이상의 추적 처리 세션에서 소비자에게 이벤트를 전달합니다.
ProcessTraceAddBufferToBufferStream OpenTraceFromBufferStream에서 만든 처리 세션에 ETW 추적 버퍼를 제공합니다.
ProcessTraceBufferDecrementReference ProcessTraceBufferIncrementReference에서 추가한 버퍼에 대한 참조를 해제합니다.
ProcessTraceBufferIncrementReference 제공된 버퍼에서 BufferCallback 중에 호출되어 호출자가 이를 수행할 때까지 해제되지 않도록 합니다.
QueryAllTracesA ANSI(QueryAllTracesA) 함수(evntrace.h) 함수는 호출자가 쿼리할 수 있는 모든 이벤트 추적 세션에 대한 속성과 통계를 검색합니다.
QueryAllTracesW QueryAllTracesW(유니코드) 함수(evntrace.h) 함수는 호출자가 쿼리할 수 있는 모든 이벤트 추적 세션에 대한 속성과 통계를 검색합니다.
QueryTraceA ANSI(QueryTraceA) 함수(evntrace.h)는 지정된 이벤트 추적 세션에 대한 속성 설정 및 세션 통계를 검색합니다.
QueryTraceProcessingHandle OpenTrace에서 연 ETW 추적 처리 세션에 대한 정보를 검색합니다.
QueryTraceW QueryTraceW(유니코드) 함수(evntrace.h)는 지정된 이벤트 추적 세션에 대한 속성 설정 및 세션 통계를 검색합니다.
RegisterTraceGuidsA ANSI(RegisterTraceGuidsA) 함수(evntrace.h)는 사용되지 않는 함수이며 새 코드는 제공된 대안을 사용해야 합니다.
RegisterTraceGuidsW RegisterTraceGuidsW(유니코드) 함수(evntrace.h)는 사용되지 않는 함수이며 새 코드는 제공된 대안을 사용해야 합니다.
RemoveTraceCallback RemoveTraceCallback 함수는 EventCallback 함수가 이벤트 추적 클래스에 대한 이벤트를 수신하는 것을 중지합니다. 이 함수는 사용되지 않습니다.
SetTraceCallback SetTraceCallback 함수는 지정된 이벤트 추적 클래스에 대한 이벤트를 처리하는 EventCallback 함수를 지정합니다. 이 함수는 사용되지 않습니다.
StartTraceA StartTrace 함수는 이벤트 추적 세션을 시작합니다. (ANSI)
StartTraceW StartTrace 함수는 이벤트 추적 세션을 시작합니다. (유니코드)
StopTraceA STOPTraceA(ANSI) 함수(evntrace.h)는 지정된 이벤트 추적 세션을 중지합니다. ControlTrace 함수는 이 함수를 대체합니다.
StopTraceW StopTraceW(유니코드) 함수(evntrace.h)는 지정된 이벤트 추적 세션을 중지합니다. ControlTrace 함수는 이 함수를 대체합니다.
TraceEvent RegisterTraceGuids 기반("클래식") 이벤트 공급자는 TraceEvent 함수를 사용하여 구조적 이벤트를 이벤트 추적 세션으로 보냅니다.
TraceEventInstance RegisterTraceGuids 기반("클래식") 이벤트 공급자는 TraceEventInstance 함수를 사용하여 구조화된 이벤트를 instance 식별자가 있는 이벤트 추적 세션으로 보냅니다.
TraceMessage RegisterTraceGuids 기반("클래식") 이벤트 공급자는 TraceMessage 함수를 사용하여 TMF 기반 WPP(메시지 기반) 이벤트를 이벤트 추적 세션으로 보냅니다.
TraceMessageVa RegisterTraceGuids 기반("클래식") 이벤트 공급자는 TraceMessageVa 함수를 사용하여 메시지 기반(TMF 기반 WPP) 이벤트를 va_list 매개 변수를 사용하여 이벤트 추적 세션으로 보냅니다.
TraceQueryInformation 이벤트 추적 세션에 대한 정보를 제공합니다.
TraceSetInformation 이벤트 추적 세션 설정을 구성합니다.
UnregisterTraceGuids RegisterTraceGuids를 사용하여 등록된 "클래식"(Windows 2000 스타일) ETW 이벤트 추적 공급자를 등록 취소합니다.
UpdateTraceA ANSI(UpdateTraceA) 함수(evntrace.h)는 지정된 이벤트 추적 세션의 속성 설정을 업데이트합니다.
UpdateTraceW UpdateTraceW(유니코드) 함수(evntrace.h)는 지정된 이벤트 추적 세션의 속성 설정을 업데이트합니다.

콜백 함수

PETW_BUFFER_CALLBACK ProcessTrace에서 호출할 BufferCallback에 대한 함수 정의입니다.
PETW_BUFFER_COMPLETION_CALLBACK ProcessTraceAddBufferToBufferStream이 버퍼로 완료될 때 발생할 콜백에 대한 함수 정의입니다. 이 콜백은 일반적으로 버퍼를 적절하게 해제해야 합니다.
PEVENT_CALLBACK ETW 이벤트 소비자는 추적 처리 세션에서 이벤트를 수신하기 위해 이 콜백을 구현합니다. EventRecordCallback 콜백은 이 콜백을 대체합니다.
PEVENT_RECORD_CALLBACK ETW 이벤트 소비자는 추적 처리 세션에서 이벤트를 수신하기 위해 이 콜백을 구현합니다. PEVENT_RECORD_CALLBACK 형식은 이 콜백 함수에 대한 포인터를 정의합니다. EventRecordCallback은 애플리케이션 정의 함수 이름의 자리 표시자입니다.
PEVENT_TRACE_BUFFER_CALLBACKA ANSI(PEVENT_TRACE_BUFFER_CALLBACKA)(evntrace.h) 함수는 추적 처리 세션 중에 ETW가 보내는 이벤트의 각 버퍼에 대한 통계를 가져옵니다.
PEVENT_TRACE_BUFFER_CALLBACKW PEVENT_TRACE_BUFFER_CALLBACKW(유니코드)(evntrace.h) 함수는 추적 처리 세션 중에 ETW가 보내는 이벤트의 각 버퍼에 대한 통계를 가져옵니다.
WMIDPREQUEST RegisterTraceGuids 기반("클래식") 이벤트 공급자는 컨트롤러로부터 알림을 수신하도록 이 함수를 구현합니다. WMIDPREQUEST 형식은 이 콜백 함수에 대한 포인터를 정의합니다. ControlCallback은 애플리케이션 정의 함수 이름의 자리 표시자입니다.

구조체

CLASSIC_EVENT_ID 호출 스택 추적을 사용하도록 설정할 커널 이벤트를 식별합니다.
ENABLE_TRACE_PARAMETERS EnableTraceEx2를 통해 공급자를 사용하도록 설정하는 데 사용되는 정보를 포함합니다.
ENABLE_TRACE_PARAMETERS_V1 EnableTraceEx2를 통해 공급자를 사용하도록 설정하는 데 사용되는 정보를 포함합니다. 이 구조체는 사용되지 않습니다.
ETW_BUFFER_CALLBACK_INFORMATION BufferCallback에 ConsumerInfo 매개 변수로 제공되며 현재 처리 세션에 대한 세부 정보를 제공합니다.
ETW_BUFFER_CONTEXT 이벤트에 대한 컨텍스트 정보를 제공합니다.
ETW_BUFFER_HEADER ETW 버퍼의 헤더 구조입니다.
ETW_OPEN_TRACE_OPTIONS OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions 함수에 대한 구성 매개 변수를 제공합니다.
ETW_TRACE_PARTITION_INFORMATION ETW 추적에서 가져온 파티션 정보를 포함합니다.
EVENT_INSTANCE_HEADER EVENT_INSTANCE_HEADER 구조에는 TraceEventInstance에서 작성한 모든 이벤트에 공통적인 표준 이벤트 추적 정보가 포함되어 있습니다.
EVENT_INSTANCE_INFO EVENT_INSTANCE_INFO 구조체는 TraceEventInstance에 대해 등록된 이벤트 추적 클래스에 고유한 트랜잭션 식별자를 매핑합니다.
EVENT_TRACE EVENT_TRACE 구조는 이벤트 추적 소비자에게 이벤트 정보를 전달하는 데 사용됩니다.
EVENT_TRACE_HEADER EVENT_TRACE_HEADER 구조에는 TraceEvent에서 작성한 모든 이벤트에 공통적인 표준 이벤트 추적 정보가 포함되어 있습니다.
EVENT_TRACE_LOGFILEA ANSI(EVENT_TRACE_LOGFILEA) 구조체(evntrace.h)는 추적 데이터 원본에 대한 정보를 저장합니다.
EVENT_TRACE_LOGFILEW EVENT_TRACE_LOGFILEW(유니코드) 구조체(evntrace.h)는 추적 데이터 원본에 대한 정보를 저장합니다.
EVENT_TRACE_PROPERTIES EVENT_TRACE_PROPERTIES 구조는 이벤트 추적 세션에 대한 정보를 포함하며 StartTrace 및 ControlTrace와 같은 API와 함께 사용됩니다.
EVENT_TRACE_PROPERTIES_V2 EVENT_TRACE_PROPERTIES_V2 구조는 이벤트 추적 세션에 대한 정보를 포함하며 StartTrace 및 ControlTrace와 같은 API와 함께 사용됩니다.
MOF_FIELD MOF_FIELD 구조를 사용하여 이벤트 데이터를 EVENT_TRACE_HEADER 또는 EVENT_INSTANCE_HEADER 구조에 추가할 수 있습니다.
TRACE_ENABLE_INFO 세션과 세션이 공급자를 사용하도록 설정하는 데 사용한 정보를 정의합니다.
TRACE_GUID_INFO EnumerateTraceGuidsEx에서 반환됩니다. 공급자를 사용하도록 설정한 세션 목록에 대한 헤더를 정의합니다.
TRACE_GUID_PROPERTIES EnumerateTraceGuids에서 반환됩니다. 이벤트 추적 공급자에 대한 정보를 포함합니다.
TRACE_GUID_REGISTRATION RegisterTraceGuids와 함께 이벤트 추적 클래스를 등록하는 데 사용됩니다.
TRACE_LOGFILE_HEADER TRACE_LOGFILE_HEADER 구조에는 이벤트 추적 세션 및 해당 이벤트에 대한 정보가 포함됩니다.
TRACE_PERIODIC_CAPTURE_STATE_INFO TraceQueryInformation 및 TraceSetInformation과 함께 사용하여 주기적인 캡처 상태와 관련된 정보를 얻거나 설정합니다.
TRACE_PROVIDER_INSTANCE_INFO 공급자 GUID의 instance 정의합니다.
TRACE_VERSION_INFO TraceLogging 세션의 버전 정보를 결정합니다.

열거형

ETW_PROCESS_HANDLE_INFO_TYPE 추적 처리 세션에서 수행할 작업을 지정합니다.
ETW_PROCESS_TRACE_MODES 지원되는 프로세스 추적 모드를 지정합니다.
TRACE_QUERY_INFO_CLASS EnumerateTraceGuidsEx 및 TraceSetInformation과 함께 추적 정보 유형을 지정하는 데 사용됩니다.