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 함수를 사용하여 인스턴스 식별자가 있는 이벤트 추적 세션에 구조적 이벤트를 보냅니다. |
| 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_CONTEXT_REGISTER_INFO 컨텍스트 등록 추적을 사용하도록 설정할 때 기록할 레지스터 집합을 식별합니다. |
| 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의 인스턴스를 정의합니다. |
| TRACE_VERSION_INFO TraceLogging 세션의 버전 정보를 결정합니다. |
열거형
| ETW_CONTEXT_REGISTER_TYPES 컨텍스트 레지스터 추적을 사용할 때 수집할 레지스터 집합을 지정합니다. |
| ETW_PROCESS_HANDLE_INFO_TYPE 추적 처리 세션에서 수행할 작업을 지정합니다. |
| ETW_PROCESS_TRACE_MODES 지원되는 프로세스 추적 모드를 지정합니다. |
| TRACE_QUERY_INFO_CLASS EnumerateTraceGuidsEx 및 TraceSetInformation과 함께 추적 정보 유형을 지정하는 데 사용됩니다. |