EventProvider의 CaptureStateOnDemand

아티클
07/17/2024

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

요소 계층 구조

< WindowsPerformanceRecorder>
- < Profiles>
  - < EventProvider>
    - < CaptureStateOnDemand>
  - < Profile>
    - < Collectors>
      - < EventCollectorId>
        
        < EventProviderId>
        
        < CaptureStateOnDemand>
        
        < EventProvider>
        
        < CaptureStateOnDemand>

구문

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnDemand>

특성 및 요소

특성

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>
  <CaptureStateOnDemand>
    <Keyword Value="0xff4"/> <!-- Provider is  enabled with these keywords when user initiates wpr -capturestateondemand command. -->
  </CaptureStateOnDemand>
</EventProvider>

요소

키워드(SystemProvider 내)

CustomKeyword

CaptureStateOnStart

CaptureStateOnSave