EventDefinitionType 복합 형식
공급자가 작성할 수 있는 이벤트를 정의합니다.
<xs:complexType name="EventDefinitionType">
<xs:simpleContent>
<xs:extension
base="string"
>
<xs:attribute name="value"
type="UInt32Type"
use="required"
/>
<xs:attribute name="level"
type="QName"
use="optional"
/>
<xs:attribute name="template"
type="token"
use="optional"
/>
<xs:attribute name="channel"
type="token"
use="optional"
/>
<xs:attribute name="keywords"
type="QNameList"
use="optional"
/>
<xs:attribute name="task"
type="QName"
use="optional"
/>
<xs:attribute name="opcode"
type="QName"
use="optional"
/>
<xs:attribute name="symbol"
type="CSymbolType"
use="optional"
/>
<xs:attribute name="version"
type="unsignedByte"
use="optional"
/>
<xs:attribute name="message"
type="strTableRef"
use="optional"
/>
<xs:attribute name="notLogged"
type="boolean"
use="optional"
default="false"
/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
특성
| 이름 | 형식 | Description |
|---|---|---|
| 채널 | token | 이벤트가 기록되는 채널을 식별하는 식별자입니다. 정의하거나 가져온 채널 중 하나의 채널 식별자를 지정합니다. 채널에서 채널 식별자를 지정하지 않으면 채널 이름을 사용합니다. 채널 정의 또는 가져오기에 대한 자세한 내용은 ChannelListType 복합 형식을 참조하세요. 채널을 지정하지 않으면 이벤트가 채널에 기록되지 않습니다. 일반적으로 채널을 지정하지 않는 유일한 이유는 ETW 세션에만 이벤트를 작성하는 경우입니다. 자세한 내용은 ETW 세션 만들기를 참조 하세요. 이벤트 추적 세션 제어를 참조하세요. |
| 키워드 | QNameList | 이 이벤트가 속한 이벤트의 범주를 식별하는 공백으로 구분된 키워드(keyword) 이름 목록입니다. 정의하는 키워드 목록에서 키워드(keyword) 이름을 지정합니다. 키워드 정의에 대한 자세한 내용은 KeywordType 복합 형식을 참조하세요. 키워드를 지정하지 않으면 이벤트 설명자에 키워드에 대한 0이 포함됩니다. |
| 수준 | QName | 이벤트를 작성할 때 사용할 세부 정보 수준입니다. 매니페스트에 정의한 수준의 이름 또는 Windows SDK에 포함된 \Include\Winmeta.xml 파일에 정의된 수준 중 하나를 지정합니다. 수준 정의에 대한 자세한 내용은 LevelType 복합 형식을 참조하세요. 수준을 지정하지 않으면 이벤트 설명자에 수준 0이 포함됩니다. 이벤트가 기록되는 채널 형식이 관리 경우 수준을 지정해야 합니다. 수준은 Winmeata.xml 정의된 다음 수준 중 하나여야 합니다.
|
| message | strTableRef | 이벤트에 대한 지역화된 메시지입니다. 메시지 문자열은 매니페스트의 stringTable 섹션에서 지역화된 문자열을 참조합니다. 이벤트가 기록되는 채널 형식이 관리 경우 메시지를 지정해야 합니다. |
| notLogged | boolean | 공급자가 이 이벤트를 기록할지 여부를 결정합니다. 공급자가 이 이벤트를 기록하면 true를 지정합니다. 그렇지 않으면 false입니다. 이 특성을 사용하여 공급자가 매니페스트에서 이벤트를 제거하는 대신 이 이벤트를 더 이상 로깅하지 않음을 나타냅니다. 매니페스트에 이벤트를 유지하면 소비자가 이벤트를 포함하는 이전 etl 파일을 디코딩할 수 있습니다. Windows Server 2008 및 Windows Vista: 이 특성은 Windows SDK의 Windows 7 버전 이전에 제공된 메시지 컴파일러 버전에서는 지원되지 않습니다. |
| Opcode | QName | 작업 내에서 작업을 식별하는 opcode의 이름입니다. 매니페스트에 정의한 opcode의 이름 또는 Winmeta.xml 정의된 opcode 중 하나를 지정합니다. opcode 정의에 대한 자세한 내용은 OpcodeType 복합 형식을 참조하세요. 참조하는 작업에 작업별(로컬) opcode가 포함된 경우 해당 작업별 opcode 중 하나 또는 공급자 수준(전역 opcode)에 정의된 opcode를 지정할 수 있습니다. 전역 opcode를 지정하는 경우 전역 opcode 값은 작업에 대한 로컬 opcode 중 하나와 같을 수 없습니다. 로컬 opcode를 참조하는 경우 작업 특성은 로컬 opcode가 속한 작업을 참조해야 합니다. opcode를 지정하지 않으면 이벤트 설명자에 opcode에 대한 0이 포함됩니다. |
| 기호 | CSymbolType | 애플리케이션에서 이 이벤트에 대한 이벤트 설명자를 참조하는 데 사용할 기호입니다.
메시지 컴파일러(MC.exe)는 기호를 사용하여 컴파일러가 생성하는 헤더 파일에서 이벤트 설명자에 대한 상수를 만듭니다. 기호를 지정하지 않으면 컴파일러에서 기호를 생성합니다.
EventWrite 함수를 호출하여 이벤트를 작성할 때 설명자를 사용합니다. |
| task | QName | 이 이벤트를 생성하는 구성 요소 또는 하위 구성 요소를 식별하는 작업의 이름입니다. 매니페스트에서 정의한 작업의 이름을 지정합니다. 작업 정의에 대한 자세한 내용은 TaskType 복합 형식을 참조하세요. 작업을 지정하지 않으면 이벤트 설명자에 작업에 대한 0이 포함됩니다. |
| template | token | 이 이벤트에 포함된 데이터 항목을 정의하는 템플릿의 템플릿 식별자입니다. 매니페스트에서 정의한 템플릿의 식별자를 지정합니다. 템플릿 정의에 대한 자세한 내용은 TemplateItemType 복합 형식을 참조하세요. |
| 값 | UInt32Type | 이벤트 식별자입니다. 식별자는 정의한 이벤트 목록 내에서 고유해야 합니다. |
| 버전 | unsignedByte | 이벤트 정의의 1 바이트 버전 번호입니다. |
설명
EvtFormatMessage를 사용하여 이벤트에 대한 메시지 문자열의 서식을 지정하거나 이벤트 뷰어 사용하여 메시지 문자열을 보는 경우 메시지 문자열에는 삽입 문자열과 Win32 FormatMessage 함수에서 지원하는 형식 문자열이 포함될 수 있습니다. 삽입 문자열은 %n 또는 %n!s!으로 제한됩니다. (예: %1) 여기서 n 은 이벤트의 템플릿에 정의된 데이터 항목을 하나의 기반 참조입니다. 메시지 문자열에는 %%n 형식의 매개 변수 삽입 문자열(예: %%4)도 포함될 수 있습니다. 메시지에 포함될 수 있는 최대 삽입 문자열 수는 100개입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 [데스크톱 앱만 해당] |