다음을 통해 공유

EventProvider의 CaptureStateOnSave

  • 아티클

추적이 저장될 때 캡처할 이벤트를 설명하는 키워드 컬렉션을 나타냅니다. 라이브러리는 수집기가 저장되면 공급자에게 상태 정보를 기록하도록 요청합니다. Operation 특성을 지정하면 Keyword 요소를 설정하거나 컬렉션에 추가할 수 있습니다.

요소 계층 구조

구문

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnSave>

특성 및 요소

특성

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

자식 요소

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

부모 요소

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

예제

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

<EventProvider Id="EventProvider_DWMWin32k_CaptureState" Name="e7ef96be-969f-414f-97d7-3ddb7b558ccc" NonPagedMemory="true" CaptureStateOnly="true" > 
  <!-- CaptureStateOnly="true" means provider is not enabled throughout the tracing session. -->
  <CaptureStateOnSave>
    <Keyword Value="0x80000"/> <!-- Provider is enabled with these keywords when tracing is saved. -->
  </CaptureStateOnSave>
</EventProvider>

요소

CustomKeyword

CaptureStateOnStart

CaptureStateOnDemand(EventProvider의 경우)