PCW_CALLBACK_TYPE 열거형(wdm.h)

  • 아티클

열거형은 PCW_CALLBACK_TYPE 시스템에서 공급자 정의 PCW_CALLBACK 함수로 보낸 알림의 유형을 정의합니다. 시스템은 콜백의 매개 변수에서 Type 이 열거형의 값을 전달합니다.

Syntax

typedef enum _PCW_CALLBACK_TYPE {
  PcwCallbackAddCounter,
  PcwCallbackRemoveCounter,
  PcwCallbackEnumerateInstances,
  PcwCallbackCollectData
} PCW_CALLBACK_TYPE, *PPCW_CALLBACK_TYPE;

상수

 
PcwCallbackAddCounter
시스템은 이 값으로 공급자의 콜백을 호출하여 소비자가 이 Type 카운터 세트와 관련된 쿼리에 instance 필터를 추가했음을 공급자에게 알립니다.

대부분의 공급자는 이 Type로 알림을 무시하지만 일부는 이 알림을 사용하여 데이터 수집을 최적화할 수 있습니다. 예를 들어 공급자는 각 AddCounter 알림에 대한 전역 카운터를 사용하고 전역 카운터가 0이 아닌 경우에만 성능 데이터를 추적할 수 있습니다 InterlockedIncrement .
PcwCallbackRemoveCounter
시스템은 이 값으로 공급자의 콜백을 호출하여 소비자가 이 Type 카운터 세트와 관련된 쿼리에서 instance 필터를 제거했음을 공급자에게 알립니다.

대부분의 공급자는 이 Type로 알림을 무시하지만 일부는 이 알림을 사용하여 데이터 수집을 최적화할 수 있습니다. 예를 들어 공급자는 각 RemoveCounter 알림에 대한 전역 카운터를 사용하고 전역 카운터가 0이 아닌 경우에만 성능 데이터를 추적할 수 있습니다 InterlockedDecrement .
PcwCallbackEnumerateInstances
시스템은 이 Type 값으로 공급자의 콜백을 호출하여 공급자에게 카운터 세트 인스턴스에 대한 이름 및 ID 값을 제공하도록 요청합니다.

대부분의 공급자는 PcwCallbackEnumerateInstances 및 PcwCallbackCollectData 알림에 동일한 구현을 사용하지만 일부는 PcwCallbackEnumerateInstances 콜백에 응답할 때 카운터 데이터 값의 컬렉션을 건너뛰어 데이터 수집을 최적화할 수 있습니다.
PcwCallbackCollectData
시스템은 이 Type 값을 사용하여 공급자의 콜백을 호출하여 공급자에게 카운터 세트 인스턴스에 대한 이름, ID 및 카운터 데이터 값을 제공하도록 요청합니다.

이 알림을 처리하는 자세한 내용 및 예제는 PCW_CALLBACK 함수에 대한 설명서를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 및 이후 버전의 Windows에서 사용할 수 있습니다.
머리글 wdm.h(Wdm.h, Ntddk.h 포함)

추가 정보

PCW_CALLBACK 콜백 함수