EVENT_DESCRIPTOR 구조체(relogger.h)
EVENT_DESCRIPTOR 구조에는 이벤트를 정의하는 메타데이터가 포함되어 있습니다.
구문
typedef struct _EVENT_DESCRIPTOR {
USHORT Id;
UCHAR Version;
UCHAR Channel;
UCHAR Level;
UCHAR Opcode;
USHORT Task;
ULONGLONG Keyword;
} EVENT_DESCRIPTOR, *PEVENT_DESCRIPTOR;
멤버
Id
이벤트 식별자입니다.
Version
이벤트의 버전입니다. 버전은 이벤트 정의의 수정 버전을 나타냅니다. 이 멤버와 ID 멤버를 사용하여 공급자의 scope 내에서 이벤트를 고유하게 식별할 수 있습니다.
Channel
이벤트의 대상 그룹(예: 관리자 또는 개발자)입니다.
Level
이벤트에 포함된 심각도 또는 세부 수준(예: 정보 또는 치명적)입니다.
Opcode
작업 내에서 수행되는 작업 시퀀스의 단계입니다.
Task
애플리케이션 또는 구성 요소 내에서 더 큰 작업 단위입니다(Opcode보다 넓음).
Keyword
관련 이벤트의 논리적 그룹을 지정하는 비트 마스크입니다. 각 비트는 하나의 그룹에 해당합니다. 이벤트는 하나 이상의 그룹에 속할 수 있습니다. 키워드에 하나 이상의 공급자 정의 키워드 또는 표준 키워드가 있거나 둘 다 포함될 수 있습니다.
설명
이 구조체는 매니페스트에 정의된 이벤트를 나타냅니다. 이 구조를 선언하고 채웁니다. 대신 메시지 컴파일러(MC.exe) 를 사용하여 매니페스트의 각 이벤트에 대해 이 구조를 선언하고 채우는 헤더 파일을 생성합니다. 매니페스트를 작성하고 헤더 파일을 생성하는 방법에 대한 자세한 내용은 계측 매니페스트 작성 및 계측 매니페스트 컴파일을 참조하세요.
이 구조체의 멤버에 대한 자세한 내용은 EventDefinitionType 복합 형식의 특성을 참조하세요.
EventWrite 또는EventWriteTransfer를 호출하여 이벤트를 작성할 때 이 구조를 지정합니다. EventEnabled를 호출할 때 이를 사용하여 이벤트를 작성해야 하는지 여부를 결정할 수도 있습니다.
이 구조체는 EventRecordCallback 콜백을 사용하여 이벤트를 사용할 때 이벤트 레코드와 함께 반환되는 EVENT_HEADER 구조에도 포함됩니다. MOF 정의 이벤트의 경우 Opcode 멤버에는 이벤트 형식 값이 포함됩니다. 버전 및 수준 멤버에는 예상 정보가 포함됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | relogger.h(Evntprov.h 포함) |