다음을 통해 공유

EventProvider의 CaptureStateOnStart

기록을 시작할 때 캡처할 이벤트를 설명하는 키워드 컬렉션을 나타냅니다. 라이브러리는 공급자가 사용하도록 설정된 경우 공급자에게 해당 상태 정보를 기록하도록 요청합니다. Operation 특성을 지정하면 Keyword 요소를 설정하거나 컬렉션에 추가할 수 있습니다.

요소 계층 구조

구문

<CaptureStateOnStart Operation = "Set" | "Add"> | “Remove”

  <!-- Child elements -->
  Keyword

</CaptureStateOnStart>

특성 및 요소

특성

attribute Description 데이터 형식 필수 기본값
작업 키워드를 설정하거나 추가해야 하는지 여부를 나타냅니다. 이 특성에는 다음 값 중 하나가 있을 수 있습니다.
  • 설정
  • 추가
  • 제거
 예 설정

자식 요소

요소 Description 요구 사항
Keyword(EventProvider 내) 사용자 모드 공급자에 대한 ETW(Windows용 이벤트 추적) 키워드를 설명합니다. 필수(하나 이상)

부모 요소

요소 Description
EventProvider 프로필에 대한 이벤트 공급자를 나타냅니다.
EventProviderId 이벤트 공급자 식별자를 나타냅니다.

예제

다음 코드 예제에서는 이 요소를 사용하는 방법을 보여 집니다.

<EventProvider Id="sample-provider" Name="SampleProvider" NonPagedMemory="true" Level="5">
  <Keywords>
    <Keyword Value="0x98"/> <!-- Provider is enabled with these keywords throughout tracing session -->
  </Keywords>
  <CaptureStateOnStart>
    <Keyword Value="0xff4"/> <!-- Provider is  enabled with these keywords when tracing is started. -->
  </CaptureStateOnStart>
  <CaptureStateOnSave>
    <Keyword Value="0x118"/> <!-- Provider is enabled with these keywords when tracing is saved. -->
  </CaptureStateOnSave>
</EventProvider>

요소

CustomKeyword

CaptureStateOnSave

  • Last updated on